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TI Tiva™ C 系列 微 控制 器 采用 基于 ARM® Cortexm - M4 内 核 的 卓越 架构 ， 具 备 强 大 的 集 
成 能 力 ， 提 供 了 成 熟 的 软件 和 开发 工具 生态 系统 ， 是 舰 入 式 工程 师 的 理想 选择 。 为 了 提供 最 
佳 的 性 能 和 灵活 性 ，Tiva™ C 系列 架构 推出 了 具有 FPU、 各 种 集成 存储 器 以 及 可 编程 GPIO 
的 80 MHz Cortex - M4 微 控制 器 。Tiva™ C 系列 可 集成 适合 特殊 应 用 的 外 设 ， 以 及 广泛 的 软 
件 工具 选项 ， 能 大 大 降低 电路 板 成 本 ， 缩 短 产 品 的 设计 周期 ， 是 用 户 理想 的 成 本 效益 型 解决 
方案 。 

随 着 TI Stellaries M3 系列 微 控制 器 逐步 退出 历史 舞台 ，Tiva™ C 系列 芯片 可 帮助 用 户 缩 
短 产 品 上 市 时 间 、 节 省 开发 成 本 ， 成 为 高 性 能 32 位 应 用 的 优选 。 但 市 面 上 或 网 络 中 有 关 
TM4C123G 系列 微 控 制 器 的 书籍 和 资料 还 很 少 ， 使 初学 者 很 难 上 手 ， 所 以 编撰 一 本 有 关 
Tiva" C 系列 微 控制 器 的 技术 手册 和 入门 级 教科 书 很 有 必要 ， 本 书 就 是 在 这 样 的 形势 下 实 
施 的 。 

本 书 历时 一 年 多 ， 于 2014 年 3 月 底 完 成 初稿 ， 因 笔者 4 月 份 生病 住院 而 耽误 了 书 的 进 
展 。 今 年 1 月 按照 新 版 固件 库 (SW - TM4C - DRL - UG -2.0.1.11577) 重新 对 原 有 固件 库 
函数 进行 了 增 减 与 修订 ， 修 改 了 各 章 的 外 设 功能 简介 ， 增 加 了 基于 Proteus 虚拟 硬件 测试 的 
例 程 ， 并 于 2015 年 4 月 12 日 完成 全 部 工作 。 

对 于 初学 者 来 说 ， 模 仿 不 失 为 一 种 快速 掌握 Tiva™ C 系列 微 控 器 软件 编程 的 有 效 方法 ， 
参考 文献 中 提 到 的 一 家 公司 为 Stellaries M3 能 被 国内 的 广大 用 户 接受 做 了 大 量 的 推广 工作 ， 
并 留 下 了 许多 宝贵 的 网 络 资源 。 国 内 的 其 他 科技 公司 和 大 学 也 为 Stellaries M3 的 推广 做 了 一 
些 有 益 工 作 ， 但 它们 采用 了 不 同 的 ARM Cortex 开发 软件 ， 这 给 初学 者 使 用 这 些 宝贵 资源 带 
来 了 不 少 的 麻烦 。 为 了 规避 这 些 问题 ， 本 书 较 详细 地 介绍 了 KeilS for ARM 、IAR for ARM、 
CCS 6 软件 的 使 用 方法 ， 为 没有 LaunchPad 实验 板 或 硬件 、 测 试 仪器 其 乏 的 读者 专门 介绍 了 
基于 Proteus 8. 1 的 软件 测试 方法 ， 因 为 仅 就 软件 编程 与 测试 方法 来 说 ，ARM Cortex M3 和 
M4 并 无 多 大 区 别 。 

本 书 握 弃 了 传统 的 通过 配置 寄存 器 来 开发 AMR Cortex M4 的 程序 开发 模式 (51 单片机 
式 的 )， 可 大 大 加 快 编写 软件 与 测试 的 进度 ， 降 低 开 发 者 的 入 门 门槛 。 因 为 目前 国外 多 采用 
基于 模型 设计 的 软件 开发 方法 ， 仅 需 开 发 者 把 主要 精力 投入 算法 模型 的 研究 上 ， 代 码 由 计算 
机 自动 生成 。 基 于 固件 的 开发 本 质 上 也 继承 了 基于 模型 的 观点 ， 让 工程 师 从 详细 了 解 超 
1000 页 的 M4 芯片 数据 手册 ， 以 及 配置 寄存 器 代码 的 长 时 间 劳 动 中 解放 出 来 。 把 这 些 困 难 与 
繁重 的 工作 交 由 芯片 生产 厂家 去 完成 〈 编 写 各 寄存 器 的 固件 库 函 数 代 码 ) ， 开 发 者 仅 需 专注 
项 目的 实现 方法 即 可 。 本 书 紧 扣 固件 库 函 数 这 一 核心 ， 共 16 章 ， 详 细 介 绍 了 固件 库 函 数 的 
功能 及 使 用 方法 ， 在 书后 附录 中 给 出 了 常用 固件 库 函 数 的 功能 简介 (为 了 压缩 本 书 的 厚度 
省 略 了 注意 事项 ， 读 者 在 查阅 附录 时 请 留意 ， 如 果 遇 到 使 用 问题 可 参考 SW -TM4C - DRL - 
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UG -2.0.1.11377 固件 库 原文 ) ， 以 期 初学 者 能 快速 掌握 基于 固件 的 ARM Cortex M4 的 软件 
开发 与 测试 方法 。 

有 关 ARM Cortex 架构 的 书籍 及 网 络 资源 很 多 ， 本 书 不 再 歼 述 这 部 分 内 容 。 对 于 不 了 解 
ARM Cortex 架构 的 读者 ， 在 学 习 本 书 之 前 请 先行 阅读 ARM Cortex - M3 权威 指南 一 书 ， 这 里 
仅 给 出 Tiva”TM4C123x 的 模块 框图 ， 如 下 图 所 示 。 
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函数 的 初始 翻译 与 资料 整理 工作 ， 机 械 工业 出 版 社 的 时 静 编 辑 对 本 书 的 进展 进行 了 全 程 监控 
并 对 书 的 结构 提出 了 宝贵 的 建议 ， 在 此 一 并 感谢 ,没有 他 们 的 辛勤 劳动 与 帮助 不 可 能 完成 本 
书 的 编撰 工作 。 

由 于 书 中 代 技 术 资 料 的 翻译 与 整理 工作 量 较 大 ， 而 且 时 间 紧 任务 重 ， 加 之 自己 的 水 平 
有 限 ， 肯 定 存在 对 TI 技术 文献 的 理解 歧义 和 错误 ， 敬 请 读者 批评 指正 。 
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第 上 章 


开发 工具 使 用 入 门 


本 章 将 简单 介绍 CCS6 、Keil for ARM 、IAR for ARM 与 SW - EK - TM4C123GXL 驱动 程 
序 的 安装 及 其 使 用 方法 。 


本 章 的 主要 内 容 : 


> CCSS 的 安装 及 使 用 方法 

> Keil for ARM 的 安装 及 使 用 方法 
> IAR for ARM 的 安装 及 使 用 方法 
> ICDI 驱动 程序 的 安装 


SW - EK - TM4C123GXL 软件 包 的 下 载 地 址 : http://www. ti.com/tool/SW - EK 
— TM4C123GXL 

主要 包括 以 下 软件 : 

① 基于 CCS5/6 的 软件 包 。 

② 基于 IAR 的 软件 包 。 

③ 基于 KEIL 的 软件 包 。 

待 下载 的 三 个 软件 包 如 图 1-1 所 示 ， 已 下 载 的 EK - TM4C123GXL - CCS 软件 包 内 容 如 
图 1-2 所 示 ， 然 后 按照 手册 的 说 明 安 装 这 三 个 软件 包 。 限 于 篇 幅 这 里 不 再 详 述 。 














Buy from Texas * 

Part Number Instruments 
EK-TM4C123GXL-CCS: Free 

IvaWare for eries and Code Composer Studio for the 
Tiva C Series TM4C123G LaunchPad et Software 
EK-TM4C123GXL-IAR: Free 
TivaWare for C Series and IAR Embedded WorkDench for 4 
the Tiva C Series TM4C123G LaunchPad Get Software 
EK-TM4C123GXL-KEIL: Free 

ivaWare for eries and Keil RVMDK for the Tiva C 
Series TM4C123G LaunchPad Get Software 





图 1-1 等 下 载 的 软件 





注意 : 三 个 软件 包 与 LaunchPad 板子 相关 的 驱动 程序 都 是 相同 的 ， 只 安装 一 次 即 可 。 
双击 菜单 TivaWare 中 的 SW - EK - TM4C -2.0.1.11577. exe， 开 始 安装 TivaWare 开发 软 
件 包 (如 图 1-2 所 示 ) ， 安 装 完成 后 的 开发 软件 包 目 录 树 如 图 1-3 所 示 。 






































r TY 
病 EK-TM4C123GXL Firmware Development Pac... | 三間 回 ベー 
= 由 Velcome to the Texas Instruments 
TE MN E:T: iMaWare2EKcTM4C123GXL Firmware 0 
for C Series Development Packaqe Setup Wizard 陸生 
The Setup Wizard will install the EK-TM4C123GXL Firmware drivers 
Development Package on your Computer. Click Next to continue examples 
or Cancel to exit the Setup Wizard. grlib 
inc 
IQmath 
sensorlib 
third_party 
tools 
usblib 
Bee _ cancg | ue 
し J windows_drivers 
图 1-2 安装 EK -TM4C123GXL 开发 包 图 1-3 TivaWare 开发 软件 包 目 录 

















导 人 已 存在 的 工程 


1) 按 默认 状态 打开 一 个 工作 空间 ， 如 图 1-4 所 示 。 


Select a workspace 





Code Composer Studio stores your projects in a folder called a workspace. 


Choose a workspace folder to use for this session. 
Browse... 














Workspace: URE UDUINLS Es 


| 」Use this as the default and do not ask again 




















图 1-4 打开 的 默认 工作 空间 


2) 导入 库 函 数 。 在 主 菜单 栏 的 Project 下 拉 菜 单 中 选择 Import Existing CCS Eclipse Pro- 
ject 子 菜单 ， 在 弹出 的 对 话 框 中 按 Browser 按钮 寻找 并 导入 driverlib (驱动 库 ) 、usblib 
(usb 库 ) 和 grlib (图 形 库 ) 库 困 数 ， 同 时 选中 Copy project into workspace 选项 ， 如 
图 1-5、1-6 所 示 。 

注意 : 若 用 户 安 装 的 是 SW -EK -TM4C -2.0.1.11577 软件 包 ， 则 图 1-6 中 的 TivaWare 
_C_Series 目录 应 该 替换 成 TivaWare_C_Series -2.0.1.11577。 

3) 将 EK -TM4C123GXL (LaunchPad) 开发 板 的 例 程 导 入 工作 空间 ， 如 图 1-7 所 示 。 








と 。 io 
wa CCS Edit - TI Resource Ex 






































キマ A ;斯 直 芯 NeW CCS Project 
= 三 CCS 電 xample Projects 
に I | Build 
Build Pr 








Waa pd 


BL , ロ AutO| 
Show Build 





Add Files.… 





EB | Import Existing CCS Eclipse Project 
Import Legacy CCSv3.3 Project 








4) 编译 


图 1-5 选中 Import Existing CCS 
Eclipse Project 子 菜单 


调试 已 存在 的 工程 。 











回 


KY Import CCS Eclipse Projects 





Select Existing CCS Eclipse Project 


Select a directory to search for existing CCS Eclipse projects. 








® Select search-directory: 
© Select archive file: 


Discovered projects: 











Select root directory of ec to 1mport 


し 





| 浏览 文件 夹 








ィ 1 Chaare.c_serie> 








rd | 
」 doc 
Open the Re p 区 日 人 
上 上 examples 











1-6 添加 库 函 数 的 过 程 


① 左 键 单 击 某 工程 来 激活 该 工程 ， 比 如 激活 的 hello 工程 如 图 1-8 所 示 。 





wc Import CCS Eclipse Projects 





回 le = 














Select Existing CCS Eclipse Project | 時 开发 板 例 程 一 二 


® Select search-directory: |C:\ti\TivaWare_C_Series\examples\| 


Discovered projects: 












































ンク 
尻 面 timers [C:\ti\TivaWare_C TTP s\boards\d 4 | | selectAll | All | 
区 | 合 udma_demo I[C:\t\TivaWare_Gres\examples\bc | | 
| DeselectAll 

区 | 吉 capsense [Cti\TivaWare_C _Series\examples\board 到 | 

图 语 hello [C:\ti\TivaWare_C_Series\examples\boards\ek | 
民主 freertos_demo [C:\ti\TivaWare_C_Series\examples\ | 

贱 | 写 mpu_fault [CriNTivaWare_C_Seriesvexamplesuboar| 選 中 


II 





ト 











国 








Copy projects into workspace | 

















(の 








Automatically import referenced projects 

















区 











② 右键 单 击 hello 工程 , 


1-7 导入 EK - TM4C123GXL 开发 板 例 程 


如 图 1-9 所 示 。 





Pi 











っ Project Explorer | 














p YE alrmouse 
瑟 bitband 
5 良 blinky 


Bb 


Pb 。、. ME 


bp 这 freertos_demo 
: 記 gpio_jtag 
rs = 
了 grlib 
:Slhello [Active - Debug] | 
b 3 humidity_sht21 
TS 。 
トラ Interrupts 
b 3 light_isI29023 
: 3 mpu_fault 
emer ーーー 
| 名 uec_dev bc,…、 
bE usb_dev serial 


p usblib 








a a 


1 
































名 








1-8 使 hello 工程 处 于 激活 状态 











| Bi Problems $2 

















"Finished building target:| hello.out "| 


post-build 
"C:/ti/ccsv5/utils/tiobj2bin/tiobj2bin" 
"hello.out" "hello.bin" 


"C:/ti/ccsv5/utils/tiobj2bin/mkhex4bin" 





|**#g Build Finished **** 


旦 console | 4 个 图 田 国 如 | 中 昌 vr” 
CDT Build Console [hello] 
<Linking> 還 A-” en 


C:/t ュ 1/ccsv5/uti1s/bin/gmake --no-print-directory 


"C:/t1/ccsv5/too1s/comp1ler/arm_5.9.1/bin/armofd" 
"C:/ti/ccsv5/tools/compiler/arm 5.0.1/bin/armhex" 





0 errors, 1 warning, 0 others 
] 52 A 
Description 


: 際 Warnings (1 item) 




















四 | 























图 1-9 编译 结果 生成 . out 格式 可 执行 文件 


一 


在 弹出 的 下 拉 菜 单 中 选择 Build Project 编译 hello 工程 ， 其 结 





5) 在 EK-TM4C123GXL 开发 板 中 运行 . out 文件 。 

① 创建 目标 配置 文件 〈. ccxml 文件 ) 。 操 作 步 又 : 选中 File— New—Target Configuration 
File 选项 a 在 弹出 的 Target Configuration 来 菜单 中 给 .ccxml 文件 命名 为 LaunchPad , 如 
图 1-10 所 示 。 




















sz New Target Configuration ke 回 ズー | 











Target Configuration 


Create a new Target Configuration file. 


File name: |LaunchPad.ccxml 


| Use shared location | 








Location: C:/Users/liuyu/ti/CCSTargetConfigurations| |Fils Sy 
日 




















人 @@ Finish Cancel | 
图 1-10 给 .ccxml 文件 命名 为 LaunchPad 


② 在 LaunchPad. cexml 文件 中 指定 ARM Cortex 芯片 与 仿真 器 ， 然 后 按 右 侧 的 Save 按钮 
保存 配置 ， 如 图 1-11 所 示 。 








Basic 指定 仿真 器 # 


General Setup ” Advanced Setup 
This section describes the general configuration about the target. 9 


Connection Stellaris In-Circuit Debug Interface Target Configuration: 
































Board or Device type filter text 选择 芯 5 
Tiva TM4C123GH6PGE a * |save | 
Save 
以 | Tiva TM4C123GH6PM 
「 | Tiva TM4C123GH6PZ Test Connection 


图 1-11 在 LaunchPad. cexml 文件 中 指定 仿真 器 与 所 用 芯片 


③ 右 击 LaunchPad. ccxml 文件 ， 在 弹出 的 下 拉 菜 单 中 单 击 Launch Selected Configuration 
选项 ， 发 出 目标 配置 信息 ， 如 图 1-12 所 示 。 


| Target Configurations 33| 加 其 ” 





type filter text 


让 Projects 
4 EE User Defined 
| 局 LM9B96.ccxml is © 
| 
二 New NE PPT 
| Import Tardtt Configuration | 





| % Delete \ | 
Rename \ | 

w Refresh Al ©) 

| | Launch Selected Configuration 


Sat as Nefault 


1-12 发 出 目标 配置 信息 











④ 按 图 1-13 所 示 步 又 导入 . out 文件 并 启动 程序 在 EK - TM4C123GXL 开发 板 上 运行 。 
为 了 观察 在 . out 文件 在 EK -TM4C123GXL 开发 板 中 的 运行 结果 ， 下 面 将 采用 puTTY 串口 助 
手 来 观察 其 运行 结果 。 





I 国際 > CCs Deb.… 


上 Debug | mW ssa. 0 
4 rn ccxml [Code Composer Studio - Device Debugging] | 
uo Stellaris In-Circuit Debug Interface_0/CORTEX_M4_0 (Suspended - H 

三 main() at hello.c:107 Ox000006D4 | 


三 _c_int000 at boot.asm:217 0x000008E2 (_c_int00 has only skeletal 
| 


























图 1-13 导入 . out 文件 的 过 程 及 启动 程序 在 EK - TM4C123GXL 中 测试 
6) 寻找 EK - TM4C123GXL 板子 的 虚拟 串口 号 与 配置 串口 ， 如 图 1-14a、b 所 示 。 




























































































要 
| 文件 (F) 操作 (A) 查看 (V) 帮助 (H) 
| 所 区 | 古国 | 日 畏 | 上 
各 计算 机 管理 (本 地 ) 4 网 iuyu-pc| 
4 前 系统 工具 ; 二 DVD/CD-ROM 驱动 器 = = 
@ 任务 计划 程序 > で 語 DE ATA/ATAPI 控制 器 | Stellaris Virtual Serial Port (COM7) 屋 性 ea 
”图 事件 查看 器 部 Jungo | = 有 ニー ニー ュー | 
;国共 享 文件 夹 , 本 stellarisIn-CircuitDebug1 LaunchPad | 准 規 | 半量 | 信和 
r 部 本 地 用 户 和 组 > 本 处 理 器 的 虚拟 串口 号 
号 
因 性 能 -磁盘 驱动 路 2 立 / 种 (B) : ee 
当 设备 管理 器 4 导语 D (COM 和 LPT) の 位 /各 P 
4 咎 存储 WT ELTIMA Virtual Serial Pog{eom1- >COM2) DD: | 
填 磁盘 管理 全 ELTIMA Virtual Serial Pgrt (COM2->COM1) | 配置 串口 = 
記 服务 和 应 用 程序 | 全 ELTIMA Virtual Serig or (COM3: >COM4) | 奇偶 校 验 (F): 
| | 
从 上 位 (8); | 
流 控制 (F) : 
| 高揚..。 | [还 原 默 认 值 G) | 
4 
a) b) 


图 1-14 
a) 寻找 EK -TM4C123GXL 板子 的 虚拟 是 


7) 配置 puTTY 串口 参数 如 图 1-15 所 示 。 





口号 b) 配置 虚拟 串口 参数 











Ud 











『 
門 PuTTY Configuration lm 














Category: 
日 -Session | Basic options for your PuTTY session 
: “Logging DR 
日 | Specify the destination youwantto connectto 
| -Keyboard Serial line Speed 
| :Bell COM7 115200| 
re Connection type: 
RABpSanee DRaw Telnet DRlogin @)SSH 





Behaviour Load. save or delete a stored session 
… Translation 


Se プー 、 ノー or 
图 1-15 配置 puTTY 串口 参数 




















说 明 : 对 于 不 同 的 EK -TM4C123CXL 开发 板 和 电脑 ， 可 能 分 配 不 同 的 虚拟 事 口 。 








8) 重启 动 . out 文件 在 EK - TM4C123GXL 中 运行 ， 在 puTTY 中 显示 的 测试 结果 ， 如 


图 1-16a、b 所 示 。 
な Debug 3| 家 ly | 3 の を | 強 マ や | 遇 8 | | 8 coM7 - purry le 回 著 < 位 
A 


4 本 LaunchPad.ccxml [Code Composer studio - Device Debugging] _ 
2 Stellaris Im-Circuit Debug Interface_07CORTEX_M4_0 (Running) 






































< 四 | 四 











a) b) 


图 1-16 
a) 重新 启动 .out 文件 在 EK - TM4C123GXL 开发 板 中 运行 b) 在 puTTY 显示 的 开发 板 运行 结 生 


7 中 








创建 一 个 新 工程 


1) 在 主 菜 单 中 选择 Project 一 New CCS Project, 在 弹出 的 工作 空间 创建 一 个 新 工程 ， 如 
图 1-17 所 示 。 








< FPP 
sx CCS Edit - TI Resource Explorer - Code Composer Studig 
Ee 


File Edit View Navigate [Project| Ru Scripts Window Help 








1-17 创建 一 个 新 工程 


2) 配置 新 工程 〈 见 图 1-18) ， 然 后 按 Finish 按钮 完成 新 工程 配置 ， 生 成 的 Myproject 工 
程 如 图 1-19 所 示 。 











wr New CCS Project 





CCS Project 








Create a new CCS Project. 


Myproject 


Output type: |Executable 回 | 


Project name: 











区 Use default location 








( Ci\Users\liuyu\workspace_v5_3\hello_world Browse 
MV スーー 选中 ARM 类 指定 具体 芯 
Family: 
Variant: Stellaris Cortex LM4F12x ~ |Stellaris LM4F120H5QR 4 





Connection: | 





» Advanced settings 


选择 工程 模板 


type filter text っ イ Creates an empty project fully 
。 | initialized for the selected device. 











+ Project templates and examples 











4 同 Empty Projects ンク 
記 Empty Project 在 | 
WWW main.c 
号 Empty Assembly-only Projt ~ 

(アー みこ の ーッ ーー 

图 1-18 ”新 工程 配置 

注意 : 没有 特别 说 明 的 ， 接 受 默 认 设 置 。 

3) 创建 或 添加 . e 文件 到 新 建 的 工程 中 。 

① 将 project0 工程 中 的 project0. e 文件 内 容 全 部 复制 到 main.c 文件 中 ， 然 后 保存 该 


文件 。 
6 





























@ 或 右键 单 击 Myproject 工程 , 在 弾 出 的 下 拉 菜 単 中 単 吉 添加 文件 (Add Files...) 选项 
(如 图 1-20 所 示 ) , 添加 hello. c 文件 ， 用 同样 的 方式 把 startup_ccs. c 文件 到 工程 中 ， 然 后 删 
除 工程 中 的 main.c 文件 。 


EprojectExplorer 如 | 日 气 ” 


| 愛 blinky 
;路 driverlib | 新建 的 工程 M 
于 interrupts | A fault 
做 p | 4 回 IMyproject [ta Rename... F2 


; 这 mpu_fault 6 
> | Incluges | i Import... 
人 Myproject [Active - Debug] lm Imaf1 和 Kh5( £4 Export... 




















? Hl Includes Na 、 
ntti | n.c 
b [人 Im4f121h5qr.cmd dS 4 这 b | 
& 回 main.c | Mec .oo Ma > 
| 国 target_con mdex » 


; 于 project0 


, 瑟 qs-rgb 川 "至 qs-rgb Add Files.… 


gs 
上 i timers 


5 良 tp 5 ーーーーー ゲー | Debug As 1 
图 1-19 新 建 的 工程 及 自动 生成 的 文件 图 1-20 添加 文件 


























注意 : 对 于 不 涉及 中 断 处 理 的 工程 ， 可 以 直接 把 其 他 工程 的 startup_ccs. c 文件 复制 到 新 
建 工程 中 ， 或 采用 创建 工程 时 自动 生成 startup_ccs. c 文件 ; 如 果 所 建 工 程 涉及 中 断 处 理 ， 则 
需 将 函数 名 添加 到 中 断 向 量 表 中 。 

4) 添加 包含 文件 与 库 文件 的 搜索 路 径 。 添 加 搜索 路 径 有 两 种 方法 : 绝对 路 径 与 相对 
路 径 。 

① 绝对 路 径 : 把 所 需 的 包含 文件 的 绝对 路 径 添加 到 如 图 1-21 所 示 的 栏 中 。 操 作 步 又 
为 : 右键 单 击 Myproject 工程 ， 在 弹出 的 下 拉 菜 单 中 选择 属性 (Properies) 选项 ， 然 后 按 
图 1-21 编号 的 步 又 进行 操作 ， 最 后 单 击 OK 按钮 将 需要 的 包含 文件 路 径 添 加 到 搜索 路 径 栏 中 。 
























































wlProperties for Myproject に エコ 工程 属性 一 El Xx 
pe 中 1 に mr Add directory path 
Resoukce cB 
‘ene Directory: 
a Build 
4[ARM Compiled| Ci\ti\TivaWare_C_Series 号 ~ 
Pwgcessor Options oy 
pi 和 mization 导航 到 ⑤ 
De ptions "や ご 
~ に 
MISRA-C:2004 
> Advanced Options 
» ARM Linker 
= ニー ュー この 
Debug Add dir to #include search path (--include_path, や ⑧) 时 過 神尾 
Task Tags re OOL ROOTIywinclude， 
"C:\t\TivaWare_C Series" GD 
添加 的 包含 文件 
搜索 路 径 











人 @@ Show advanced settings 














图 1-21 添加 包含 文件 绝对 路 径 的 步骤 





用 同样 方法 把 库 文件 添加 到 库 文件 搜索 路 径 中 ， 如 图 1-22 所 示 。 
② 相对 路 径 : 


























ゞ 7 Properties for Myproje 工程 属性 
lype fer tht | | File Search Path ED 
> Resourcq 
General | 
4 Build , Configuration: Debug [Active ] ~| | Manage Configurations... | 
> i 





[ERM Linted 
Basic On 
[File Search Path| m= 
> Advanced Options 
Debug 


ご 
Include ibrar file orcommand feaninput lio el Ba 恒 伺 | 


_ 添加 的 库 文件 搜索 路 | 


| Add eo to librar EEHi path (--search_path, -i) 
|"${CG TOOL ROOTi/LD" 



















Fz Add file path 








File: 


CiNiNTivaWare_C_Series\driverlibyccsNDebug\driverlib.lib| 


ES EE 


图 1-22 添加 库 文 件 绝对 路 径 的 步骤 














首先 在 Build 菜单 下 选中 Variables 选项 ， 然 后 单 击 右边 的 添加 (Add) 按钮 ， 创 建 
ORIGINAL_PROJECT_ROOT 和 SW_ROOT 西條 変量 , 如 較 1-23 所 示 。 在 搜索 路 径 栏 中 引用 
变量 产生 相对 路 径 ， 如 图 1-24 所 示 。 


1Build | = ニュ ニー Configuration: |Debug [Active 1 ~| | Manage Configurations... 
ARM Compiler Pe 


"a ① 
ARM Linker ニニ = ー - - 
Debug | 日 Builder | © Behaviour | 3 SteBP® Variables Link Order | 8 Dependencies 


| Task Tags 



































Name Type Value を 2 办 [dd | 
ORIGINAL... Directory C:/t/TivaWare_C_Series/examples/boards/ek-tm4c123gxl/project0/ccs 3 
SW_ROOT Directory $(ORIGINAL_PROJECT_ROOT 7 = テー 
Delete 
创建 变量 

















| 属性 页 面 


4 Resource 





Linked Resources 
Resource Filters 
General 
4 Build 


4IARM Compiler 


ProsEssor Options 


Optiization 
Debu ptions 


Include Options| =. 














MISRA-C:2004 
”Advanced Options 
ARM Linker ーーーーーーーーーーーーーーーーーー 
| Add dir to #include search path ( 
Debug pr n 
include 
Task Tags 


"${SW_ROOT}/examples/boards/ek-tm4c123gxl" 
"${SW_ROOT}" 


























图 1-24 添加 包含 文件 的 相对 搜索 路 径 
用 同样 方法 添加 库 文件 的 相对 搜索 路 径 ， 如 图 1-25 所 示 。 


属性 页 面 








Include library file or command file as inp Srafy, 山 a 
ARM Compiler "libc.a" ニーー 
4| ARM Linker 
Basic Option ニニ ーーー 
> Advanced Options 搜索 路 径 Pp 
Debug 和 在 


Task Tags 


¥ Edit file path 








File: 0 








メグ 
ー イ ーー jl 的 库 文件 相 寺 i 








ーー ナー ニー か テー アア ナム ーー クー ニー テー アー 


图 1-25 ”添加 库 文件 的 相对 搜索 路 径 
5) 编译 配置 成 相对 搜索 路 径 的 Myproject 工程 ， 其 步骤 及 结果 如 图 1-26a、b 所 示 。 



























































BIgegBkplorenial BS%” DOxplorer _ 
下 bitband ^ <stdint. 
[ 副 ariverl 
2 
Ctrl+C 
Ctrl+V = ーー 一 
Delete ー 58 ーー 个 图 | 国 辐 蕊 | dy 
,re Se に ICDT Build Console [Myprojectl 
本 、 | -- del -o "Myproject.out" "./startup_ccs.obj" 
b NN Move 单 过 编译 gt dy 一 
bp 到 Debug Rename.… 。 | -/project@.obj "bea 
ja Myproject |-1"C: \ti\TivaWare_C_Series\examples\boards\ek-tm4c123gx1l\ 
b Lm Im4f121h5qr.d Import 工程 lproject9\ccs\..\-\.\..\--/driver1ib/ccs/Debug/driverlib 
» 回 project0.c Ort... |-1ib" "../lm4f121h5qr. cmd" 
» 回 startup_ccs.c = |<Linking> 
4 8 project0 Show Build Settipgs® | "Finished bui1ding target: |Myproject.out" 
> 韦 Binaries Build Project i 
j | 编译 结果 生 
し 本 Incl ーー up ーー |**** Build Finished **** 编译 结果 生成 .ou 文件 
- ダー iderolectee ーー - 
a) b) 


图 1-26 
a) 编译 Myproject 工程 b) 设置 成 相对 搜索 路 径 的 Myproject 工程 的 编译 结果 


LM 闪存 编程 器 


本 小 节 将 介绍 LM 闪存 编程 器 的 基本 使 用 方法 及 编程 示例 。 

1) LM 闪存 编程 器 是 一 个 独立 的 GUI 编程 ， 允 许 用 户 通 过 多 个 端口 编程 Stellaris ( Tiva ) 
器 件 的 闪存 。 

2) 确保 在 CCS 中 没有 运行 代码 的 调试 透视 图 ， 以 避免 CCS 和 
Flash 编程 因 USB 端口 控制 权 发 生 冲 突 。 单 击 桌面 上 如 图 1-27 所 
示 的 图 标 ， 打 开 闪 存 编程 对 话 框 ， 如 图 1-28 所 示 。 

3) 在 配置 ( Configuration) 选项 的 快速 设置 ( Quick Set) 栏 中 
选 定 所 需 编程 的 开发 板 ， 例 如 选中 LM4F120 LaunchPad (EK - 
TM4C123GXL 评估 板 ) 。 图 1-27 LM Flash 图 标 


























LM Flash Programmer - Build 1470 一 一 
Configuration | Program | Flash Utilties | other Utiites| Help 
Quick Set 
「 Interface | 
Port: [rae >| 


ICDI (Eval Board) マ 
2000000 


Speed 





Clock Source 


@ Using the S 














lp TEXAS INSTRUMENTS 


le | 























1-28 LM Flash 编程 器 界面 


4) 这 里 对 Flash Utilities 和 Other Utilities 选项 按 默认 设置 。 对 这 两 个 选项 设置 感 兴趣 的 
用 户 请 参考 右上 角 的 帮助 (Help) 文件 ， 如 图 1-29 所 示 。 

5) 单 击 Program 选项 ， 对 Options 栏 进行 如 图 1-30 所 示 的 设置 。 然 后 按 Select . bin file 
栏 的 浏览 (browse) 按钮 ， 选 择 Myproject 编译 生成 的 . bin 文件 ， 如 图 1-31 所 示 。 


-Options 





Erase Method: 


LM Flash Programmer - Build 1470 
(@ Erase Entire Flash - (faster) 





Configuration | Program Flash Utilities | Other Utilities | 


Erase- 
| (@ Entire Flash Start Address: of? a | 


全 By Address Range End Address: ep [ Blank Check After Erase 
kte み ーーー デュ プア " の すず ーー ニー プー 
1-29 LM Flash 编程 的 帮助 文件 

















(Erase Necessary Paqes - (slower) 
[¢ Verify After Program 
[|v Reset MCU After Program 


Program Address Offset: |0 




















图 1-30 Options 的 设置 












































图 打开 
es | っ | os 
组 织 ~ 新 建文 件 夫 
各 最 5 访问 的 位 置 ^ 名称 
に 产 没有 与 搜索 条 件 匹 配 的 项 
| 
看 . 视频 = ,本 
中 图 を - 
~~ アー ーー ee | 
トー 计算 机 无 bm 格式 文件 生成 
总 > 本 地 磁盘 (C) の 
文件 名 (N) - 
し 








1-31 编译 结果 中 不 存在 . bin 格式 文件 
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6) 创建 闪存 编程 器 的 bin 格式 文件 。 要 编译 生成 . bin 格式 文件 必须 在 Build 选项 下 的 


Steps 栏 中 添加 以 下 命令 ， 如 图 1-32 所 示 。 


属性 页 面 
-Ed ーー 


4 ARM CoB ユー ニュ ュー 


の 





Configuration: |pebug [Active ] -| | Manage Configurations. 




















に コ 

Processor Options ーー 

Optimization ™ Builder Beha r| 3 Steps | 太 Variables | 机 Environment | 2 Link Order | 3 Del * 

Debug Options Pre-build steps も 

Include Options Command: \ 

MISRA-C:2004 て 

> Advanced Options \ 添加 的 命令 
; ARM Linker Description: WM 
Debug 3 | | > 
Task Tags \ | 


Post-build steps 
Command: 


"$(BuildAr 


*$【CCE_INSTALL_ ROOTj/utils/tiobj2bin/tiobj2bin" "$(BuildArtifactFileNamei" 





Description: 


PA ed sh eo pS ed ケー ニテ ターーー チュ ここ ュー テート mlell 
1-32 在 Steps 栏 中 的 Command 选项 处 添加 的 命令 (見 下 ①、 ② 所 迷 


① 对 于 CCS 3. 2 及 更 早 版 本 添加 以 下 命令 ; 


























到 











" $1CCS_INSTALL_ROOT!} /utils/tiobj2bin/tiobj2bin" 

" ${ Build ArtifactFileName} " " $1 BuildArtifactFileBaseName} . bin" 

" $|CG_TOOL_ROOT|/bin/ofd470" " $1{CG_TOOL_ROOT|} /bin/hex470" 
| 


" 
② 对 于 CCS 3. 3 及 更 新 的 版 本 添加 以 下 命令 : 


" $1CCE_INSTALL_ROOT! /utils/tiobj2bin/tiobj2bin" 

" $1BuildArtifactFileName} " 

" $1BuildArtifactFileBaseName|. bin" 

" $1CC_TOOL_ROOT|/bin/armofd" 
| 
| 


CCS_INSTALL_ROOT} /utils/tiobj2bin/ mkhex4bin" 


" ${ CG_TOOL_ROOT}/bin/armhex" 
" $1{ CCE_INSTALL_ROOT|} /utils/tiobj2bin/ mkhex4bin" 
③ 重新 编译 Myproject 工程 ， 其 结果 如 图 1-33 所 示 。 
7) 在 LM 闪存 编程 器 的 Program 选项 下 添加 . bin 格式 文件 ， 如 图 1-34 所 示 。 































组 织 ” 新 建文 件 夹 编译 生成 的 
回 Console 3% yy 图 胃 形 臣下 四 < マロ ロマ テロ | 加 视频 ^ 名称 bin 格 式 文件 lw 日期 
|CDT Build Console [Myproject] 局 , 图片 喇 = 
| post-bui1d 人 3 文档 RL A 


"C:/ti/ccsv5/utils/tiobj2bin/tiobj2bin" "Myproject.out" 


| 
[varsject-bin"] Pr pd 


> 地 磁 癌 (E:) 


"CC:/ モ 1/ccsv5/ 
|["C:/ti/ccsv5/t 


s/compiler/arm 5.9.1/bin/armofd" 
compiler/arm 5.9.1/bin/armhex" 


|"C :/ti/ccsv5/uti1s/ で Wa]2bin/mkhex4bin" 
WB Au 


ud Fin1shed ささ きま 


下、 编译 生成 的 bi 


格式 文件 





4 lau 


网 1-33 重新 编译 Myproject 工程 ， 


生成 的 . bin 格式 文件 








ジ DVD RW 驱动 器 (FJ] BD-LM ~ < | ! 』 














图 1-34 导入 Myproject bin 文件 到 
LM 闪存 编程 器 





ゴゴ 


77 


8) 单 击 Program 选项 下 的 Program 按钮 ,将 . bin 文件 下 载 到 EK - TM4C123GXL 评 佑 板 
中 ， 如 图 1-35、1-36 所 示 。 


LM Flash Programmer - Build 1470 = | 


Configuration Flash Utilities | Other Utilities | Help 





Select .bin file 


C:\Users\liuyu\workspace_v5_3\Myproject\Debug\Myproject.bin 











Options 





Erase Method: 
(Erase Entire Flash - (faster) 
Erase Necessary Pages - (slower) 


[lv Verify After Program 
トレ Reset MCU After Program 


Program Address Offset: P 
ne, 


-CRC32 


Source CRC32 = | OX8B812D8A Device CRC32 = | 0x8B812D8A 


Hardware Reset 


1-35 ”编程 Myproject bin 格式 文件 到 EK - TM4C123GXL 评估 板 中 
































本 小 节 将 简单 介绍 Keil ARM 的 使 用 方法 。 
作者 安装 的 MDK - ARM Microcontroller Development Kit 软件 是 4. 73 /5. 14 版 的 ， 可 在 其 
官方 网 站 下 载 : http://www. keil. com/arm/mdk. asp。 


导 人 一 个 hello 工程 


1) 导入 一 个 hello 工程 。 
① 打开 Keil kVision 4 软件 ， 如 图 1-37 所 示 。 
72 











[加 bVision4 这 
File Edit View Project Flash Debug Peripherals Tools SVCS Window Help 
% am 下 | っ ele 旨 | 下界 四 民 | 主事 半 放 | 環 

SEE 




































Eeem 


EN2 | 











Project 











電 . 10 FL rs.| 
Build Output 

















1-37 KeilrVision 4 软件 界面 


②) 单 击 菜单 栏 中 的 Project 菜单 ， 在 弹出 的 下 拉 菜 单 中 单 击 “ Open Project ”选项 ， 再 
在 弹出 的 “工程 文件 选择 对 话 框 ”中 选中 hello 工程 文件 ， 然 后 按 打开 按钮 导入 hello 工程 , 
如 图 1-38a、b 所 示 。 
























































































rr eT | に 
(SE ト し で boards » ek- -tm4c123gxd » hello » ィ | サ 上 靖 宏 eo | 
名 最 访问 的 位 置 。 ^ 名称 修改 日 其 类 型 | 
< 库 Es | ccs 2013/6/1515:08 ”文件 夹 
i 」 ewarm 2013/6/16 22:41 ”文件 去 
| gcc 2013/6/15 15:08 文件 去 
WP = vmdk 2013/6/1714:05 文件 天 startup_rvmdk.S 
sn | settings 201376/16 22:42 文件 天 寺 uartstdio.c 
Al | sourcerygy 2013/6/15 15:08 文件 去 Libraries 
间 hel 2013/6/17 14:07 国 driverlib.lib 
る 家庭 组 . LE Documentation 
ーー ター 2 人 fm ed ょ ュー デー 回 readme.tt 
文件 名 (N): | > |Project Files (*.uvproj; *.uvmp =| 导入 的 hello 工 程 
打开 (O) | 取消 
站 電 Bo.. | {} Fu.。 HL Ts. | 
a) b) 
图 1-38 


a) 导入 hello 工程 的 过 程 b) 导入 的 hello 工程 


2) 编译 hello 工程 。 
① 单 击 工具 栏 中 的 重 编译 画图 标 ， 编 译 hello 工程 ， 如 图 1-39 所 示 。 


r 









es\boards\ek-tm4c123gxINhelloVhello.uvproj 書 








ug Peripherals Tools SVCS Window Help 





















































// We are finished 


// す 
whi1e(1) 














{ 








图 1-39 单 击 “Rebuild all” 图 标 编 译 hello 工程 
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② 在 编译 时 所 有 源 文 件 将 被 编译 和 链接 ， 且 在 kVision 4 IDE 窗口 的 底部 将 看 到 这 些 文 
件 的 编译 过 程 。 编 译 完成 后 将 生成 以 hello 命名 的 . axf 格式 文件 ， 如 图 1-40 所 示 。 


Build Output 





Rebuild target "he11o' 站 き 
compiling hello.c... 编译 生成 


assembling startup rvmdk.S... = .axf 格 式 文件 
compiling uartstdio.c. = 

linking. 

Program Se KE uo 人 188 RW-data=8 ZI-data=512 





Her Co --bin --output .\rvmdk\hello.bin .\rvmdk\hello.axf 
‘remax TT axf"|— 0 Error(s}, 0 Warning(s). 











图 1-40 hello 工程 的 编译 结果 
3) 加 载 hello 程序 到 闪存 中 。 





① 单 击 工具 栏 中 的 下 载 兽 图 标 ， 将 对 . axf 格式 文件 进行 编程 ， 其 过 程 会 持续 几 秒 ， 编 


程 结果 如 图 1-41 所 示 。 









































CNGTIvaWare_C_Seriesvexamples\boardsek-tm4c123gx_ = | 
File Edit View Prow Flash Debug Peripherals Tools SVCS Wi 
1 人 回 呈 | , 乾 品 | | | 宇 友 話 
画 沿 で nee | 苔 | 量 电 
Project 9 男 园 hello.c 回 readmetxt 
語 Source 144 // We are £1 
| 田園 hello.c 143 // 
Ei. a mdk. while (1) 


























1-41 ”点击 图 中 稍 头 所 指 图 标 对 . axf 文件 进行 编程 


② 此 时 hello. axf 文件 已 下 载 到 EK - TM4C123GXL 开发 板 中 ， 如 图 1-42 所 示 。 


Build Output n 










User command #1: fromelf --bin --output .\rvmdk\hello.bin .\rv 
".\rvmdk\hello.axf" - 0 Error(8), 0 Warning(s)}. 

Load "C:\\ti\\TivaWare C Series\\examples\\boards\\ek-tm4c123g 
Cannecting: Mode=JTAG, Speed=1000000Hz 

Erase Done 
Programming Done. 
Verify OK. 








4) 调试 和 运行 的 hello 程序 。 
① 选择 工具 栏 中 的 调试 图 标 ， 如 图 1-43 所 示 。 


Pa Sy :Ahellovhello.uvproj - uVision4 | 














Debug Pernpherals “~ 3VCS Window Help 
| Ee CE 
| 起 | 














3 内 hello.c [ mebe 的 startup_rvmdk.S |] uartstdio.c 





1-43 单 击 调试 图 标 启 动 代码 调试 








② 单 击 调试 图 标 启 动 hello 代码 调试 (此 时 将 打开 多 种 调试 窗口 ) , 
速 运 行 按钮 ， 其 结果 如 图 1-44 所 示 。 
14 





图 1-42 编程 结束 并 将 . axf 文件 下 载 到 EK -TM4C123GXL 


后 单 击 图 中 的 全 














| C:\ti\TivaWare_C_Series\examples\boards\ek-tm4c123gxl\hello\hello.uvproj - uvisio [El 回民 芝 喇 


Project Flash Debug Peripherals Tools SVCS Window Help 

















































































区 | | を | 窗 丘 族 | 棒 
き | 回] p ee nl > 回 國 a[ 還 回 = コラ ・ 時 ・g・ 画 |※・ し 
Registers 呈 岡 Disassembly 四 回 
IIRegister [Yalue っ | [oxo00006ra 2104 MOVS r1, #0x04 司 | 
站 Ox000006FC 4628 MOV r0,r5 同 | 
了 0x000006FE F7EFFFE11 BL.W GPIOPinWrite (Ox00000321 三 
RO Ox40025000 166: SysCt1De1ay (SysCt1C1ockGet () / 10 / 3): 
R1 Ox00000004 0x00000702 FTFFFE13 BL.W SysCtliClockGet (Ox0000( 
R2 Dxonooooono 0x00000706 FBBOFOF4 UDIV £0, エ 0,r4 
| R3 Qx00000000 0x0000070A F7FFFT 反 汇 编 窗口 SysCtlDelay (0x0000029( 
| Rd4 Ox0000001e 146: while 窗 
RS Ayrann2snnn 0x0000070E ETE8 B 0x000006E2 
g 0x00000710 0540 DC Ox0540 
" 存储 器 窗口 0x00000712 01CO pen ox01CO ~ 
| Ra ox00000000 * lu ! 
| RB Ox00000000 pn 
| 回 出 区 sx 
R10 0x00000000 | 半 helec 加 startop rmdks 四 readmett 2 
R11 Ox00000000 | 162 2 
R12 OxOhehc200 | 163 7 が 
R13 (SP) Ox20000208 164 // DaTav Br DE 
Ri4 (LR) 0x00000703 les // 
R15 (PC) Ox00000702 
1 166 SysctlDelay (SysCtlClockGet 9 
PsR 0x21000000 了 | CY EE EG 
由 “Banked 2 
“Systen | 168 | } 源 程序 调试 窗口 目 | 
12- Interna1 -| 169 = 
Project | 詩 Registers | a 
Command 呈 陣 Memory1 ? 贺 
Connecting: Mode=JTAG, Speed=1000000HzLc a a 
Address: |0x00 于 
0x00000000: 0 oo 20 6D 02 00 00 81 02 00 00 
0x0000000C: 00 00 85 02 00 00 85 02 oo 00 
0x00000018 0 00 00 00 00 
~ ox00000024 存储 器 窗口 。ss oz oo oo 
| ox00000030 0 85 02 00 oo 
ox0000003C oo go 85 02 00 go 85 02 00 oo ~ 
> i nvnnnnnnas nn nn as na nn nn as _ na nn nn 
EE 调试 命令 窗口 jeakRK ュ 11 | call stack + Locals | Watch 1 | 国 Memory 1 























图 1-44 ”多 种 调试 窗口 的 运行 截图 
@) 此 时 hello 程序 的 运行 结果 在 puTTY 中 的 显示 如 图 1-45 所 示 。 


























并 COM7 - PuTTY = 回 七生 








1-45 hello 程序 在 puTTY 中 的 显示 结果 
注意 : puTTY 串口 助手 的 设置 和 前 面 的 一 致 


创建 一 个 hello 工程 


1) 创建 C: \ti\TivaWare_C_Series - 2.0.1.11577\examples\boards \my_board 文件 来 。 

( 注 : 如 果 读 者 所 建 工 程 找 不 到 搜索 路 径 ， 可 放弃 此 步骤 直接 将 新 建 工 程 放 在 C:\GVTi- 
vaWare_C_Series -2. 0. 1. 11577 \examples \boards \ek - tm4c123gxl 目录 下 。) 

在 此 目录 下 创建 My_ project 工程 ， 其 创建 过 程 如 图 1-46 ~ 图 1-50 所 示 。 















File Edit View Tools SVC 


1 区 吉 加 | 





New Multi-Project Workspace... 
Open Project... 







Save Project in Vision4 format 








器 


1-46 创建 新 工程 
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- 廊 TM4C123GE6PM 
到 TM4C123GE6PZ 








劉 TM4C123GH6PZ 

劉 TM4C123GH6ZRB 

劉 TM4C123GH6ZXR 
mm $ TM4C129x Series 





师 计算 机 
ee HE 1 


zhe 


保存 类 型 (T): [Project Files (*.uvproj) 




















图 1-47 新 建 My_project 工程 图 1-48 选择 工程 中 使 用 的 芯片 型 号 














ー 
CMiVTivaWare_C_Seriesuexamples\boardsvmy_board\ 





File Edit Viewr Project Flash Debug Peripherals Tools 
3 唱 信 コ 厚 |* 品目 | 2 el と | 末 殆 机 昌 | 
BI に | 球 | 晶 計 











| HVision 





全 3 | | Target 1 





@ Copy "Startup.s' to Project Folder and Add File to Project ? 











图 1-49 接受 生成 Startup. s 文件 到 工程 中 图 1-50 创建 的 空 工程 
2) 为 工程 创建 与 添加 源 文件 ， 如 图 1-51 ~ 图 1-53 所 示 。 


File Edit View Project Flash Debug Peripherals “ 
六 窜 开 
“| 起 | 里 






































| 日 -党 Target 1 
3- Source Group 
Startup.s 


























Open File 区 Options for Group 'Libaries'… 
Open List File Open File 
Open Map File 5 Open List File 
添 Open Map File 
‘ebuild all target files 加 
Id target ebuild all target files 
库 Wld target 
slate File 国 
Tra 租 late File 
uild 数 
图 1-51 给 空 工程 中 添加 新 组 图 1-52 给 Libaries 组 中 添加 库 函 数 


3) 配置 硬件 。 首 先 在 工具 栏 中 单 击 |& 图 标 ， 打 开 Options for Target“Target 1” 对 话 框 
(如 图 1-54 所 示 ) ， 再 在 Device 选项 下 选择 TM4C123GH6PM 芯片 ， 然 后 按 图 示 进 行 设置 ， 
最 后 单 击 OK 按钮 确认 。 
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CAti\TivaWare_C_Series\examples\boards\my_board\My_project\My_prc 





File Edit View Project Flash Debug Peripherals Tools SVCS Window He 


添加 的 工程 | | (a 
所 需 的 文件 | Target 1 























日 -党 Target 1 





日 所 Source Group 1 
| Startup.s - t 
hello.c "driverlib/debug.! 
十 | nude ™ * : 
uartstdio.c 3 SS driver11b/ fpu .h 


"ーーー driverlib/gpio:h' 
程序 中 存在 错误 fariverlib/pin mas 
driverlib/rom.h" 

图 1-53 工程 添加 的 源 文件 与 库 文件 


= 
Options for Target 'Target 1° lS 


白 - 包 Libaries 
因 driverlib.lib 














































































































loutpat | Listing | vser |c| 8g OMHz [Linker| Debug |Utilities 
Texas Instruments LM4F120H5QR 
mm Code Generation 
xtal (MHz) 加 
Operating system: |None 了 | 「 Use Cross-Module Optimization 
に 3 Use MicroLB Big Endian 
SFDNLuminarLM4F120H5QR SFR Poemq Pow esse: tlie 工 
Read/Only Memory Areas Read/Write Memory Areas 
default ochip Stan Size Starup | | default ofchp Start Size Nolnit 
厂 Row1: | 「 RAMt ロ 
「 RoMz て 厂 RAMz 图 
厂 RoMs3 て 「 RAMS3 图 
on-chip on-chip 
セ mow [oo 40000 @ レ aaAwi. [m20000000 [mxaooo 画 
IROM2 D 「 MIRAM2 画 
Cance1 Defaults Help 








1-54 ”Target 选项 配置 
4) 调试 参数 配置 ， 如 图 1-55 所 示 。 


好 Options for Target 'Target 1! < | XX 
Device | Target | Output | Listing | User | 9 し 中 」 | Linke Utilities | 
Use Simulator Setings © Use: seiais DD 2 











































































| LimitSpeedto Rea-Time コ 
っ を 
[” Load Application at Startup ドレ Runto main() J Load Application at Startup レタ main0 
me pa We ン 
= ーー し 
Stellaris Debug Interface DLL ee z 图 Ed 
4 = it 
レク 
9 Sessi@n Setings 
Wp Texas INsTRUMENTS 
レッ Toolbox 
Imidk-agdi.dll build 159.0.0.0 の Pindows 
し っ = 
Target debug DLL for Stellaris microcontrollers. ジン レン Pp 按 图 示 配 置 
ー se 
し 调试 参数 
Attached Devices ze 
こ Parameter 
The drop-down menu shows all of the attached Stel (CDI 
interfaces. Select the one that you would ke MF 
Stellaris USB ICDI (SN: 0E107859) 
「 Configuration Parameter 
jpebug |pCM4 
Mode: |JTAG ry Target options: 
厂 verify flash content on 
Clock: |1 MHz Ss Debug efaults | Help 
由 Reset: |SYSRESETREQ マ "| 
Flash 
(® Page Erase (erase only necessary pages)[” Program 
(Mass Erase (erase entire Flash) [verify 
| (Do not Erase 「 Reset and Run 
用 























1-55 配置 调试 参数 
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注意 : 调试 参数 按 图 示 配 置 ， 未 提 及 的 选项 按 默 认 设置 。 
$) 按 如 图 1-56 所 示 配 置 闪存 编程 选项 ， 单 击 OK 按钮 确定 。 





所 
Options for Target Target 1' 








Device| Target | Output | Listing| User | GUO | sm | Linker | i 


レコ 





「 Configure Flash Menu Command デー 


ンズ 
5 Use TargetDriverfor Flash Programming 





Init File: | 图 Edit.. 


人 Use External Toolfor Flash Programming 


厂 RunIndependent 





elas cD ICDI Settings | し Update Targetbefore Debugging | Update Targetbefore Debugging 


Command: 图 | 
Arguments: 











Camce1 Defau1ts 





Help 














7) 配置 “Linker” 


1-36 配置 闪存 编程 选项 


6) C/C++ 编译 器 的 配置 选项 按 图 1-57 所 示 进 行 ， 单 击 OK 按钮 确认 设置 。 





Options for Target 'Target 工 


EO 





ee | Linker | Debug | Utilities 
こっ テテ 
Preprocessor Symbols 





Defne: lrvmdk PART_TM4C123GH6PM TARGET_IS_BLIZZARD_RB1 





Undefine: | 





- Language | Code Generation 








厂 StictANSIC as 
0piimization Enum Container always int 
厂 Optimize for Time 厂 Plain Charis Signed 厂 Thuml 
厂 SpltLoad and Store Multiple 厂 Read-Only Position Independent 厂 No Auto Includes 
ドレ One ELF Section per Function 厂 Read-Write Position Independent 








Misc (CS9 
oeeg で や フ 


hude [i | 本 = 一 一 一 一 一 配置 头 文件 与 库 文 件 的 搜索 路 径 





Compiler |c-cpuCorexM4fp -g -02 --apcs=interwork -split_sections -| \\\. -C99 
control le\KeiMARM\RV31INC 
string |He\KeiMRM\CMSIS\Include 














[| Cy | cnce | Defauts | 


Help 




















1-57 C/C++ 编译 器 配置 


单 击 OK 按钮 确认 ， 如 图 1-58 所 示 。 





Options for Target 'Target 1' 





LEED ST lc/crr |asn CinkePDlnebug | ttilities| 


Os Memory Layoutfrom Target Dialog の 
| Make RW Sections Posiion Independent と の 


| Make RO Sections Posiion Independent 





Scatter My_projectsct 
File 





R/O Base IOx00000000 

es RW Base |0x20000000 
DontSearch Standard Libraries 

[” Report 'mightfail Conditions as Errors Severe 

国 | 晤 Eee 





| -entry Reset_Handler 


Misc 
controls 








Linker |-cpu Cortex-M4.fp *.o 
control |-strict--scatter "My_project sct" 
string 





vy 








| Cancel Defaults 


Help 



































图 1-58 配置 “Linker” 选 项 

















8) 目标 1 选项 配置 完成 后 的 工程 文件 ， 如 图 1-59 所 示 。 


9) 编译 My_project 工程 ， 然 后 将 . axf 格式 文件 编程 到 LaunchPad 评估 板 中 ， 














已 打开 了 puTTY 串口 助手 , 将 显示 “hello world”， 如 图 1-60 所 示 。 





WW CiVTivaWare_C_Seriesexa mples\boarc 

















27 行 的 错误 标识 已 消 
File Edit View Project Flash Debug Peri 失 程序 已 可 以 识别 


project.uvF 













Fa 
Fa 


国 hello.c 
国 uartstdio.c 


日 - 電 Libaries 
国 driverlib.lib 30 














inc7hw types: 


= 回 | | 所 包含 的 基文 件 
故国 萝 | 唾 | Target1 = 
Project ? 图 [ea helloc 
日 稿 Target 1 23 / も は は は は は は は まあ は は よ ま は よ よ よる は は に よる まま まる 1 
日 -全 Source Group 1 24 作 
国 Startup.s Build Output 


如果 此 刻 





Rebuild target 'Target 1" 
assembling Startup.s... 
compiling hello.c.. . 
compiling uartstdio.c.. 
linking... 

Proqram Size: Code=2 


"My project.axf"[= 0 Error(s}, 0 Warning(s). 


FY COM7 - PuTTY 










iverlib/debug.h" 
iverlib/fpu.h" 





























31 b/gpio.h 
32 b/pin map.h 
33 b/rom.h" 
源 文 件 附帯 所 34 iv b/sysctl.h" 
包含 的 头 文件 35 "driverlib/uart.h" 
/ 36 "utils/uartstdio.h" 
37 
38 議 放 たよ よ ょ ょ よさ よ よ よさ よさ で すす すす すす よ すす すす ます ます と すす すさ] 
回 p.| 直 | fF. | | < me gg 
图 1-59 选项 配置 完成 后 的 工程 文件 












编译 生成 的 .axf 文 件 





图 1-60 编译 与 运行 结果 


? 图 


FRO dara=188 RW-data=8 ZI-data=352 





本 小 节 简 介 IAR for ARM 的 使用 方 法 。 


打开 一 个 现 有 工程 


作者 安装 的 IAR 软件 为 7.10 版 ， 可 在 http://supp. iar com/Download/SW/? item = 


EWARM -EVAL 下 载 。 


1) 单 击 桌 面 上 的 大 图 标 打 开 IAR 软件 界面 ， 如 图 1-61 所 示 。 



























































縮 AR Embedded Workbench IDE 一 | 回 甩 入 
File Edit View Project Tools Window Help 
D 芒 日 印 | 鱼 | | ~ ※ 多 | 
Wokepace SX |IAR Information Center for ARM | 
Files [时 
TT 
3 = > 
IAR 有 关 ARM 的 信息 中 心 
SYSTEMS 
IReady 数字 本 











图 1-61 IAR 软件 的 初始 界面 
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2) 单 击 Pile 一 New 一 Workspace， 打 开 IAR 的 工作 空间 ， 如 图 1-62 所 示 。 





























中 IAR Embedded Workbench IDE | IE メデ 
File Edit View Project Tools Window Help 
mae 本 > 
工作 空间 
Ready 到 三 























图 1-62 工作 空间 








3) 创建 C: Nti\TivaWare_C_Series -2. 0. 1. 11577 \examples\boards \my_board 文件 夹 。 

( 注 : 如 果 读 者 所 建 工 程 找 不 到 搜索 路 径 ， 可 放弃 此 步骤 直接 将 新 建 工程 放 在 C:\GVTi- 
vaWare_C_Series -2.0.1.11577\examples\boards\ek - tm4c123gxl 目录 下 。) 

4) 在 路 径 C:Nti\TivaWare_C_Series - 2. 0. 1. 11577 \examples \boards \ek - tm4c123gxl 中 ， 
导入 库 文件 和 例 程 ， 如 图 1-63 所 示 。 

5) 在 编译 任何 工程 之 前 ， 首 先 编译 driverlib 库 ， 如 图 1-64 所 示 。 




























































































ー イ = 2 ek-tm4c123gx| - IAR Embedded Workbench IDE 
、 2 ma File Edit View Project Simulator Tools Window 
Files 加 
diwermib=Debug - helo | 
usblib - Debug マ = 
印 htthand- DeBud マン #include <st 
blinky- Debug v #include "in 
ifreertos_demo - Debug v \ mn 
gpio jtag - DeBug マ ey [ri 
a [driverlib - Debug | 
FH hello - Debug < He us -epud Opti 4 
图 interrupts - Debug v La bitband Oem ptions... 
[OD mpu_faut- Debug “ 上 四 印 binky-Debug1 
时 i > トト Eo Dfreertos_dema ee 1 
印 tmrs - Cbug v agpio jtag- Det : 村 中 
印 uar_choWMDsbug ee | Rebuild All 
加 udma_den 角 -Debug v me Clean 
Dusb_dev_ bk- Debug v > ye oC 
Dusb_dev_seWel- Debug v Paprojecd - Debu Stop Build 
還 qs-rgb - Debug 
timers -Debug | Add 
uart_echo-Det 
工程 范例 印 udma_dema-[ Remove 
Overview driverib | usblib | bithand 4 > evs hu Rename... 
图 1-63 ”导入 的 驱动 库 与 例 程 图 1-64 编译 driverlib 驱动 库 




















6) 右键 单 击 hello 工程 ， 然 后 在 弹出 的 下 拉 菜 单 中 选择 “Set as Active”， 激 活 hello 工 
程 。 再 右键 单 击 已 激活 的 hello 工程 ， 在 弹出 的 下 拉 菜 单 中 单 击 “Make” 编 译 驱 动 库 文件 ， 
如 图 1-65 所 示 。 

7) 单 击 工具 栏 中 的 下 载 与 调试 和 图 标 启 动工 程 调试 ， 此 时 程序 将 停止 在 main( ) 处 等 待 
执行 命令 ， 如 图 1-66 所 示 。 

8) 用 户 可 以 查看 和 修改 存储 器 、 程 序 变量 、 处 理 需 寄存 器 、 设 置 断 点 、 单 步 执行 程序 ， 
以 及 执行 其 他 常用 的 调试 操作 。 单 击 工具 栏 中 的 全 速 运行 图 标 岁 ， 其 运行 结果 如 
图 1-67 所 示 。 
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ジコ ek-tm4c123gx| - IAR Embedded Workbench IDE ーー 








File Edit View Se Debug Disassembly TI Stellaris Tools Window Help 


到 和 和 区 儿 昂 查 | 卫 尖 济 区 | 步 















pa 4 
Dag pe 






































































































































こ be 
= と 
Files // a Disassembly 
日 回 ek-tm4c123gd // Frint "Hella World!" to the Ox6B6: 0x6922 
HE driverlib - Debug- // Os688: Ox2103 
Ha 団 ushlib - Debug ・ ルキ ne8a: Hr6d52 
トト 団 bitband - Debug - int DOs68c: Oxf04f 
に ト 還 男 blinky き Debug - ; j ns690: 0x4790 
讽 ek-tm4c123gxl - IAR Embedded Workbenc fh (void) ns692・ 0x2105 
ーー ーー ーー 日 
Dx694: Dx481le 
File Edit View Project TIStellaris Tools //vold 程序 停止 在 了 co 0zg696: 0xft000 
口 戎 日 上 量 | 名 | 4 | 本 や っ | 0x69a: 0x4a1e 
: = Ha timers -Debug ・ の ・ Hf7ff 
Workspace Fuar echo-De..- 
PE ト FE udma_demo-...・ 
Feusb_ dev bulk-..- 5 
Files ausb_dev_serial..- | 0x6ae: 0x6900 
ェ 0x6b2: 0x6a69 
- た 
ーー トー // ge と た ne clocking to run | SE 
a ROM SysCtlClockSet (SYSCTL S nseh8: Dx4788 
| アノ ーー 
Overwiew drverib | «|» |. me 上 区 上 ii ト 
x 
Log 
Wed Jun 26. 2013 08:06:56: Hardware reset was pertormed 
Wed Jun 26. 2013 08:06:56: 2116 bytes downloaded into FLASH and verified (2.76 Kbyised) 
Wed Jun 26, 2013 08:06:56: Loaded debugee: C\t\TivavWare_C_Series\examples\bds\ek-tm4c123gxh\hello\ewarm\Exe' 
四 生 mpuj 1 Wed Jun 26. 2013 08:06:56: Hardware reset was periormed 
project0 -0D 则 Wed Jun 26. 2013 08:06:56: Target reset 
crdh | E ニ 一 
ra pe > lB” Ready Ln115, Col5 3 
ロ 2 所 FE; 
到 1-65 编译 工程 图 1-66 启动 工程 调试 














2 補 ek-tm4c123gxl - IAR Embedded Workbench IDE 





| File Edit View に Disassembly TIStellaris Tools Wir 




















ED 哆 回国 | 虽 | 六 生理 一 一 | ~ “YE 
EE i 1 

Workspace * | | 

| 

|| hello - Debug gs UARTStdioConfig(0, 
|| Files [ze 1} 


上 日 加 ek-tm4c123gxl 
driverlib - Debug 

川上 時 印 uslib - Debug 

| 句 biband-Debug 

川上 時 印 blinky- Dabug 

| Dfreertos_demo - Debug 





| ト F mpu_fault- pe 埋 A 
| projectd -Debug AN 








上 鳃 贺 qs-tgb- Debug 





ググ た た た た た た た た また また た た た た た えよ 
// 
// Print "Hello World!’ 
// 
の に たま まま まま た まま まる た また たたえ ] 
int 
main (void) 
日 【 
//volatile uint32 t 








醒 coM7 - PuTTY 
































创建 一 个 新 工程 








1) 单 击 Pile 一 New 一 Workspace， 

2) 单 击 Project 一 Create New Project, 
新 工程 。 

3) 在 弹出 的 对 话 框 中 将 工程 
工程 ， 如 图 1-70 所 示 。 

最 后 保存 工作 空间 ， 将 其 命名 为 my_IAR_project。 

4) 右键 单 击 hello_world 工程 ， 在 弹出 的 下 拉 菜 单 中 选择 
如 图 1-71 所 示 。 


新 建 一 个 工作 空 


s 间 ， 如 图 1-68 所 示 。 
在 弹出 的 菜单 中 按 如 图 1-69 进行 配置 ， 创 建 一 个 


命名 为 hello_world， 然 后 单 击 保存 按钮 ， 创 建 hello_world 





Im 


“Add Group” 为 工程 添加 组 ， 
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Em | Wo LE 

ile |(1) view Project Tools Window Help 
9 | me 

Open 


Close 











Save Workspace 
Close Workspace 


Save Ctrl+S 
Save As.… 
Save All 


Page Setup... 
Print.… Ctrl+P 








Recent Files + 
Recent Workspaces M 


Exit 











Create a new Workspace 








图 1-68 创建 工作 空间 


r 


小 IAR Embedded Workbench IDE 
















思え boards 上 my TIAR_board 









































Me "AVI 


人 


Create New project ”| 





























中 Tool chain: 











を 
: 江 AR Embedded Workbench IDE Rg 


Projecttemplates: 





r Tools Window Help 






Empty project 
由 -asm し 


二 1 4 























int main() 


{ 
| return 0; 下 
} 


图 1-69 创建 新 工程 图 1-70 新建 的 hello_world 工程 
































健 








沪 my_IAR_project - IAR Embedded Workbench IDE 








| File Edit View Project Simulator Tools Window Help 





EECTEE 四 ER 
GE 































int main() 


a 


Options... 


Make 添 
Compile 加 


Rebuild All 


Add Files... 
Add "main.c" 









Rename.… 
图 1-71 给 工程 添加 组 


$) 单 击 “Add Group” , 在 弾 出 的 対 笑 権 中 分 別 需 人 Libraries 、Source， 然 后 单 击 OK 按 
钮 为 工程 添加 Libraries 、Source 两 个 组 ， 如 图 1-72 所 示 。 
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6) 用 同样 的 方法 为 工程 添加 文件 ， 添 加 文件 后 的 工程 如 图 1-73 所 示 。 


Workspace x 










添加 的 组 
和 库 文 件 










し ー | driverlib.a 






























円 し Snurcg 
Add Group - hello_world lim | 田 四 hello.c 
田 EY startup_ewarm.c + 
Lm 回 uartstdinc + 
Libraries| 











Cancel 











Qutput 
| hello_world 添加 的 组 和 源 文件 


图 1-72 为 工程 添加 Libraries 组 1-73 ”为 工程 添加 组 和 文件 





① 在 C: \i\TivaWare_C_Series - 2. 0. 1. 11577 \driverlib \ewarm \Exe 目录 下 添加 driverlib. a 
库 文件 。 

② 在 Ci:Nti\TivaWare_C_Series - 2.0.1.11577\utils 目录 下 添加 uartstdio. c 文件 。 

@ 在 C:Nti\TivaWare_C_Series - 2.0. 1. 11577 \examples \ boards \ek - tm4c123gxl \hello 目 
录 下 添加 startup_ewarm. c 和 hello. 。 

7) 通用 选项 设置 ， 除 了 Target 选项 需 用 户 配 置 外 ， 其 他 选项 可 按 默认 设置 即 可 。 

选择 目标 硬件 选中 Device 选项 单 击 右 侧 的 目标 类 型 图 标 区 ]， 选取 
LM4F120H5QR 或 TM4C123GH6PM ， 然 后 单 击 OK 按钮 确认 ， 如 图 1-74 所 示 。 

② 查看 Output 选项 的 默认 配置 ， 如 图 1-75 所 示 。 








Options for node “hello_world” 9 



















































































Category: D ga 
RC * 
General Options 2 3 
C/C++ Compller 『 目 标 配置 1 
Assembler で out ュ > ュ 5 5 
put |Lihrary Configuration | Library Ontioi 
Output Converter | | | Target Library Configuration | Library OF 
Custom Buld 
Buid Actions Frocessor variant 16 Outnut file 输出 可 执行 文件 
Linker © Core Cortex-MdF マ ンコ MHR 行 
Debugger Li 
Simulator TexasInstruments LM4F120HSQR 回 | 1 一 Library 
EL の 4 Output directories 
erver 三 
1 i 选择 器 件 类 ee 
Ljet Little 已 Debug\Exe 
Tink/J-Trace nt NG 別 及 型 号 了 
T stelaris Pig 7 Object 
EE32 
Macraigor Debugvobj 
PE micro @ BE8 * 
STAINK = List 
bd 
“ii - に See Dobve\ist 
TxDs100 人 \ 
LA TI NIL 
图 1-74 目标 硬件 配置 1-75 输出 选项 的 默认 设置 








③ 除了 Preprocessor 选项 按 如 图 1-76 所 示 的 配置 外 ，C/C ++ 选 项 的 其 他 设置 按 默 
认 值 。 


④ Output Converter 选项 配置 如 图 1-77 所 示 。 
⑤ 除了 Setup 选项 按 如 图 1-78 所 示 的 配置 外 ， 其 他 调试 选项 按 默认 设置 。 
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Options fornod 











w 
" " 
le "hello_world i 
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1-77 Output Converter 选项 配置 
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图 1-78 Debugger 选项 的 Setup 选项 配置 


⑥ 在 LaunchPad 中 测试 程序 的 运行 结果 。 启 动 自 建 工程 的 调试 ， 如 图 1-79 所 示 。 
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File Edit View Project。Deb 单 击 启动 TIStellaris Tools 一 
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Files int J 
BE EE Be main (void) 
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Source /ATVi 二 
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// Set the clocking to run | 
hello_world 可 1 
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Log 


wed Jun 26. 2013 21:41:39: Targetreset 


Wed Jun 26. 2013 21:41:40: Downloaded CTiwaware_ 己 da Soar Y 
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图 1-79 启动 自 建 工 程 调试 
单 击 箭头 所 指 的 全 速 运行 按钮 ， 测 试 结果 如 图 1-80 所 示 。 











礁 COM7 - PuTTY ee | 








图 1-80 程序 在 LaunchPad 中 的 运行 结果 





ao 第 外 章 co 





EK - TM4C123GXL 及 Proteus 简介 








如 果 仅 就 程序 设计 与 验证 方法 来 看 ，M4 和 M3 基本 上 是 一 致 的 。 为 了 让 那些 没有 EK - 
TM4C123CXL 评估 板 或 缺乏 某 些 外 设 的 读者 也 能 随心 所 欲 的 学 习 ARM Cortex M4 的 编程 与 测 
试 方法 ， 本 章 将 简 述 EK - TM4C123GXL 评估 板 的 结构 特点 ， 以 及 基于 Proteus 8. 1 的 M3 程 
序 设计 与 其 测试 方法 。 


本 章 主要 内 容 : 


> EK -TM4C123GXL 评估 板 简介 

> Proteus 8. 1 简介 

> 虚拟 仪器 使 用 方法 

> 基于 Proteus 8. 1 的 M3 程序 设计 与 测试 方法 


Tiva TM4C123G LaunchPad 评估 板 (EK - TM4C123GXL) (如 图 2-1 所 示 ) 是 一 款 针 对 
Tiva TM4C123GH6PM 基于 ARM Cortex - M4 的 系列 微 控制 器 的 低 成 本 评 佑 平台 。 它 突出 了 
TM4C123GH6PM 微 控制 器 的 USB 2.0 接口 、 休 卢 模 块 和 运动 控制 脉 宽 调制 模块 (MC 
PWM)。 它 还 具有 可 编程 的 用 户 按 钮 和 一 个 可 用 于 自 定义 程序 的 RGB LED。 当 连接 到 许多 现 
有 的 boosterpack 附加 板 的 其 他 外 设 以 及 未 来 的 产品 ，Tiva C 系列 TM4C123G 的 LaunchPad 
BoosterPack XL 界面 可 折 秋 的 接头 将 展示 如 何 轻松 地 扩展 其 功能 。 


TM4C123GXL 的 特点 


Tiva C 系列 的 LaunchPad 包括 以下 特 点 : 
1) Tiva TM4C123CH6PM 微 控制 器 。 
2) 运动 控制 的 PWM。 
3) 基于 USB micro - A 与 micro -B 连接 需 的 USB 役 各 、 主 机 、OTG 连接 。 
4) RGB 用 户 LED。 
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PowerSelect USB Connector 
Switch (PowerICDD Green PowerLEDTiva 


TM4C123GH6PM 
Microcontroller 


DEWICE DEBUG て 日 


CT ur 


RN OS mn pot = に 






| 8 5 pr MS om TY RESE Ta 
USB Micro-A/-B 二 ーー sa Reset Switch 
Connectror 一 一 R30 MM | る 
(Device) = 一 了 TCK TMS 100 Tpi ExT xD 
1 bd DBc = | 
www iconvlaunchpgd RY 9 一 | RGB User LED 
EK-TMACI2SG REY A rn 1 Tiva C Series 
| ョ NO XL 
Tiva C Serives し 党 や ra Pz Wh Interface(J1,J2,J3 
inn の * 区 Fo sa RS の mo 法 a and J4 Connectors) 
i Pi PO PC4 IO + . 
N ンク ・ Tiva 
Interface(J2.J2.J3 je 「 PFW PD ® - -一 ES- £ TM4C123GH6PMI 


and J4 Connectors) し ざさ pe pu7 < F Microcontroller 


A と 軸 K * Pc7 pme 電 | 
信和 PDS put 机 
PDT PT3 | 

MSP430 


LaunchPad-Compatible 
BoosterPack Interface 


MSP430 
LaunchPad-Compatible 
BoosterPack Interface 

Tiva" C Series 


aunchPad の 


User Switch 1 User Switch 2 


2-1 LaunchPad 评估 板 (EK - TM4C123GXL ) 


$) 两 个 用 户 开关 (应 用 程序 /唤醒 ) 。 

6) 引出 可 用 的 VO 端口 ， 采 用 公 - 母 连 接头 间距 为 2. 54 mm。 
7) 三 袁 电 路 内 调试 鞭 口 (IODD 。 

8) 通过 开关 选择 电源 : 

QD ICDI。 

② USB 设备 。 

9) 复位 开关 。 

10) C 系列 TivaWare 外 设 驱 动 库 和 USB 库 。 


评估 板 模 块 框图 


Tiva C 系列 的 LaunchPad 包括 TM4C123CH6PM 微 控 制 器 和 一 个 集成 的 电路 内 调试 接口 
(ICDI) 以 及 一 些 有 用 的 外 设 特性 ， 其 模块 框图 如 图 2-2 所 示 。 

更 详细 的 信息 请 参考 TI 官方 文档 : “Tiva™ C Series TM4C123G LaunchPad Evaluation 
Board User’s Guide. ” 
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调试 器 分 线 点 


JTAG/SWD 
UARTO 


TivaMC Series 
LaunchPad-Specific 
BoosterPackXL 
Expansion Headers 


USB Debug TM4C123GH6PM 
Connector 





USB Device 
Connector 


LaunchPad-Compatible 
Expansion Headers 





Power Select 
Switch 





分 线 点 
图 2-2 EK -TM4C123GXL 评估 板 的 模块 框图 





为 了 压缩 本 书 的 篇 幅 ， 这 部 分 仅 就 Proteus 8. 1 界面 、 元 器 件 寻找 、 虚 拟 仪器 使 用 及 一 
个 完全 采用 Proteus 8. 1 创建 、 编 译 及 测试 的 简单 ARM Cortex 工程 来 介绍 其 使 用 与 测试 方法 。 
有 关 Proteus 8. 1 的 详细 信息 请 参考 其 官方 帮助 文档 。 
注意 : 只 有 Proteus 7. 10 或 更 高 版 本 支持 ARM Cortex M3 芯片 。 
新 增 功 能 
Proterus 8. 1 新 增 功能 如 下 : 
① 增加 了 统一 的 编译 /调试 环境 ， 以 便 调 用 后 台 的 Keli、IAR、CCS 等 ARM Cortex 开发 
工具 。 
② 新 增 了 Home Page 方便 设计 。 
@) 新 增 了 3D 浏览 
④ 原理 图 动画 功能 。 
Proteus 8. 1 界面 简介 


单 击 桌 面 的 国生 图 标 ， 可 启动 Proteus 8. 1 软件， 如 图 2-3 所 示 。 
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2-3 Proteus 8.1 界面 
从 图 2-3 中 可以 看 到 , Proteus 8 比 以 前 版 本 有 较 大 的 改变 。 
如 何 寻 找 Proteus 中 的 元 器 件 


1) 单 击 图 2-3 中 的 略 四 图标， 打开 原理 图 捕获 界面 ， 如 图 2-4 所 示 。 
全 UNTITLED - Proteus 8 Professional (BETA) - Schematic Capture に に. 回 居 : 編 


File Edit View Tool Design Graph Debug Library Template System Help 
口 苞 圆 沽 | 各国 本 本 家 国 目 王 | 全 : 国 国 | 妆 | 二 aaaa 




















































EE 


EECE3TTE 



































No Messages _ Raotsheet1 

















图 2-4 原理 图 捕获 界面 


2) 在 键盘 上 歼 字 母 忆 或 单 击 预览 窗口 下 面 的 P 字 母 ， 打 开 器 件 选择 对 话 框 ， 在 弹出 的 
对 话 框 “keywords” 栏 中 输入 LM3S3 ， 其 查询 结果 如 图 2-5 所 示 。 
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图 2-5 便捷 的 查找 所 需 元 器 件 方法 


注意 : 还 可 以 根据 元 器 件 类 别 和 厂家 查找 元 器 件 ， 记 住 一 些 常用 元 器 件 的 英文 名 称 / 简 
称 〈( 例 如 ， 电 阻 为 res) 是 必需 的 ， 以 便 加 快 元 器 件 的 查找 。 


虚拟 仪器 的 使 用 


本 小 节 仅 介绍 与 本 书 有 关 的 虚拟 示波器 和 逻辑 分 析 仪 的 使 用 方法 。 
1. 示波器 

VSM 示波器 以 ProSPICE 版 本 为 标准 ， 模 拟 了 基本 四 通道 单元 及 特性 ， 包 括 : 
1) 四 通道 ，X 一 Y 操作 。 

2) 通道 增益 从 20 V/ 毎 格 ~2mV/ 每 格 的 2.5 倍 精确 设置 。 

3) 时 基 范 围 从 200 ms/ 毎 格 ~0.5 ns/ 每 格 的 2. 5 倍 精确 设置 。 

4) 可 以 锁定 任 一 通道 的 自动 触发 电 平 。 

5) AC 或 DC 耦合 输入 。 

6) A+B 与 C+D 通道 模式 。 

7) 每 个 通道 的 反 转 按 钮 。 

8) 可 通过 鼠标 缩放 。 

9) 光标 测量 。 

10) 单 次 模式 可 能 的 缩放 。 




























































11) 打印 。 了 5 
12) 每 个 通道 可 以 单独 设置 颜色 。 wl 
(1) 示波器 的 使 用 到 | 
单 击 模式 工具 栏 中 的 名 图 标 ， 再 从 对 象 选择 窗口 中 所 列 出 に 電 
Ni 选中 虚拟 示波器 (0SCILLOSCOPE) ， 这 时 Te 
在 预览 窗口 会 显示 虚拟 示波器 的 图 标 ， 如 图 2-6 所 示 。 ⑤ 


et ot fer RN ーー 
其 中 。 将 示波器 输入 端 与 被 测 信和 号 的 输出 端 相连 。 启 动 仿真 ”图 2-6 虚拟 示 波 带 
30 


“开始 ”按钮 ， 进 行 交 互 式 仿真 ， 此 时 ， 会 出 现 虚 拟 示波器 窗口 ， 并 调节 扫描 频率 旋钮 到 合 
适 的 位 置 。 如 果 显 示 带 直流 偏 移 量 的 单 通道 ， 则 选择 AC 模式 。 调 整训 减 旋钮 和 通道 位 置 旋 
钮 获得 合适 的 波形 大 小 和 位 置 。 当 波形 是 具有 直流 电压 偏 移 量 的 交流 信号 时 ， 应 添加 一 个 隔 
直 电 容 ， 调 节 电 平 触发 旋钮 直到 显示 屏 能 捕捉 到 待 测 的 输入 波形 ， 如 图 2-7 所 示 。 
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图 2-7 虚拟 示波器 测试 波形 示意 图 


(2) 操作 模式 

示波器 有 三 种 操作 模式 ; 

① 自动 : 在 这 种 模式 下 的 自动 按钮 指示 灯 点 亮 ， 该 模式 为 系统 默认 。 

② 单 次 : 首先 关闭 自动 触发 灯 。 在 该 模式 下 单 次 灯 在 捕捉 过 程 中 被 点 亮 ， 捕 获 结束 后 
关闭 。 

③ X -Y 模式 : 利用 滑动 条 在 水 平 区 域 选 定 那个 通道 (A、B、C、D) 作为 X 通道 ， 
输出 李 沙 育 图 。 

(3) 示 波 带 的 触发 

① 虚拟 示波器 具有 自动 触发 功能 。 这 一 功能 使 得 输入 波形 可 以 与 时 基 同 步 。 

② 通过 源 (A、B、C、D) 滑 块 在 触发 区 域 选择 那 输入 通道 用 于 触发 。 

③ AC/DC 滑 块 用 于 绝对 或 链接 通道 的 触发 偏 移 量 的 选择 

④ 电 平 触发 旋钮 用 于 触发 偏 移 量 的 设置 。 

⑤ 边缘 选择 滑 块 用 于 波形 上 升 沿 与 下 降 沿 的 选择 

(4) 输入 耦合 

每 一 通道 既 可 采用 直接 耦合 方式 ， 也 可 通过 仿真 电容 采用 交流 耦合 方式 。 其 中 ， 交 流 耦 
合 方式 的 测量 适用 于 带 有 较 高 直流 偏 压 的 交流 小 信号 。 将 输入 端 临 时 接地 进行 校准 ， 这 对 于 
测量 非常 有 用 。 

(5) 光标 测量 
通过 鼠标 光标 可 以 测量 任意 点 的 电压 或 任意 两 个 点 之 间 的 电压 差 、 电 流 差 、 时 间 差 。 其 

了 7 
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步骤 为 : 首先 要 在 触发 区 域 选 中 光标 按钮 (cursors ) ， 如 果 欲 测量 任意 点 的 电压 /电流 值 ， 只 
需 移动 鼠标 到 待 测 点 单 击 左 键 即 可 ; 如 果 测 量 任意 两 点 间 的 电压 /电流 /时 间 差 ， 可 先 把 鼠标 
移动 到 待 测 的 第 一 个 点 上 ， 单 击 左 键 完 成 对 第 一 个 点 的 测量 ， 然 后 再 移动 鼠标 到 第 二 个 点 上 
单 击 左 键 完 成 对 第 二 个 点 的 测量 ， 它 们 之 间 的 差 值 很 容易 算出 。 也 可 以 通过 单 击 鼠标 左 键 选 
择 “Delete Cursor” or “Clear All Cursors” 删 除 这 些 测试 点 ， 如 图 2-8 所 示 。 




































































电压 差 =990-(-430)=1420mV 














鼠标 放置 第 
一 个 测试 点 

















第 二 测试 点 















































图 2-8 用 鼠标 光标 测量 两 点 间 电 压 差 

















2. 逻辑 分 析 仪 

逻辑 分 析 仪 连续 地 将 输入 的 数字 信息 记录 到 一 个 大 的 捕获 缓冲 区 。 这 是 一 个 采样 的 过 
程 ， 因 此 有 可 调节 的 分 辨 率 来 定义 可 以 被 采样 的 最 短 脉 冲 。 在 触发 期 间 ， 驱 动 数据 捕捉 处 理 
暂停 ， 并 监测 输入 数据 。 触 发 前 后 的 数据 都 可 显示 。 因 其 具有 非常 大 的 捕捉 缓冲 器 ( 可 存 
放 40000 个 采样 数据 ) ， 因 此 支持 放大 /缩小 显示 和 全 局 显示 。 同 时 ， 用 户 还 可 移动 测量 标 
记 ， 对 脉冲 宽度 进行 精确 定时 测量 。 

VSM 逻辑 分 析 仪 模拟 基本 的 24 通道 单元 及 特性 包括 : 

1) 8 x1 位 通道 和 4 x8 位 总 线 通 i 

2) 40000 x32 位 捕获 缓冲 器 。 

3) 捕获 分 辨 率 为 0.5 ns/ 采 样 点 ~200 js/ 采样 点 ， 相 应 的 捕捉 时 间 为 4s ~ 10 ns。 

4) 显示 的 缩放 范围 为 1 个 采样 点 / 格 ~ 1000 个 采样 点 / 格 。 

$) 输入 信号 的 逻辑 电 平 与 /或 边沿 与 总 线 值 进行 “与 ”操作 后 触发 逻辑 分 析 仪 。 

6) 触发 位 置 从 -50% 到 +50% 。 

7) 提供 两 个 坐标 用 于 精确 测量 时 间 。 

(1) 逻辑 分 析 仪 的 使 用 

捕获 和 显示 数字 数据 : 

① 在 ISIS 中 选中 仪表 按钮 并 在 对 象 选 择 髓 中 选中 LOGIC ANALYSER。 放 置 到 原理 网 编 
辑 窗口 中 连接 到 需要 测试 的 地 方 。 

② 单 击 “ 开 始 ” 按 钮 启动 交互 式 仿真 ， 逻 辑 分 析 仪 界面 将 会 出 现 。 

@) 根据 需要 调节 分 辩 率 旋钮 到 合适 位 置 ， 分 辩 率 表示 了 能 记录 的 最 小 的 脉冲 宽度 。 分 
辨 率 越 高 ， 捕 获 数据 的 时 间 间 隔 就 越 短 ， 如 图 2-9 所 示 。 
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@@ 在 仪器 的 左边 找到 复 选 框 并 设置 以 满足 要 求 的 触发 条 件 。 例 如 ， 如 果 当 连接 到 通道 0 
的 信号 为 高 且 连 接 到 通道 2 的 信号 是 上 升 沿 时 ， 想 要 驱动 仪器 ， 则 需要 设置 第 一 位 为 高 ， 第 
三 位 为 “low - High”， 如 图 2-10 所 示 。 

⑤ 根据 实际 需要 ， 确 定 是 否 查看 触发 发 生前 后 的 主要 数据 ， 并 且 调 节 位 置 旋 钮 到 需要 
触发 的 位 置 ， 如 图 2-11 所 示 。 



































图 2-9 设置 分 辨 率 图 2-10 设置 触发 条 件 图 2-11 触发 位 置 调节 


⑥ 当 设置 完成 后 ， 单 击 捕获 按钮 使 其 变 成 红色 ， 逻 辑 分 析 仪 将 等 竺 触发 事件 ， 并 连续 
捕获 输入 的 数据 ， 同 时 监控 输入 触发 条 件 。 当 触发 发 生 时 ， 捕 获 灯 将 变 成 绿色 。 数 据 捕捉 将 
一 直 进 行 ， 直 至 触发 位 置 之 后 的 捕捉 缓冲 器 满 为 止 。 此 时 ， 捕 捉 按 钮 熄灭 ， 捕 获 到 的 数据 将 
出 现在 显示 屏 上 。 

(2) 缩放 和 平移 

因为 捕捉 缓冲 器 可 以 捕捉 到 10000 个 采样 点 ， 但 是 显示 屏 仅 能 显示 400 个 像素 宽 ， 因 此 
需要 在 捕捉 缓冲 器 进行 缩放 和 平移 操作 。ZOOM 拨 盘 决定 每 格 采样 点 的 数量 ， 同 时 滚动 条 可 
以 实现 左右 移动 。 


基于 Proteus 8. 1 的 M3 编程 与 测试 


本 小 节 将 介绍 采用 Proteus 8. 1 软件 整合 工具 ， 编 辑 、 编 译 与 测试 基于 LM3S300 系列 的 
ARM Cortex 芯片 的 方法 。 
1) 单 击 Pile 一 New Project， 创 建 my_blinky 新 工程 ， 如 图 2-12 所 示 。 







































































人 = 
き New Project Wizard: Start に メー 
Project Name 
Name |ny_blinky. pdsprj 
Fath CPC:“\StellarisWare_DE_301\boards\dk-lm3s301 Browse 
©® New Project | 」From Developnent Board Elank Project 
Back | Next | | Cancel | Help 























图 2-12 创建 my_blinky 新 工程 


了 3 


注意 : 首先 在 C 盘 安 装 dk -lm3s301 软件 包 (在 随 书 配套 资源 中 找到 ) ， 便 于 M3 代码 
的 测试 。 

2) 单 击 图 2-12 中 的 Next 按钮 ,在 弹出 的 对 话 框 中 创建 工程 的 原理 图 ， 如 图 2-13 
所 示 。 





き New Project Wizard: Schematic Design [2 WU 
ーー EE 





(Do not create a schematic. 


(9) Create aschematicfrom the selected template. 


Design Templates 


GEFAUET ウ ~ 
| Landscape AD 选择 默 
| Landscape Al1 认 模 板 
Landscapg A2 
Landscape A3 


A4 

angappRR gp ham md net het sn 
Portrait A4 \ 

由 LS 


CXPrngramDatalLahcenter ElectrnnicstPrnteu: ofessional\ Templates\DEFAULT.DTI 





























图 2-13 为 工程 创建 一 个 原理 图 


3) 选中 默认 模板 ， 然 后 单 击 图 2-13 中 的 Next 按钮 ， 在 弹出 的 对 话 框 中 按 图 2-14 所 示 
选择 。 











r | 
き New Project Wizard: PCB Layout eg lm | | 


_ CreateaPCH layoutfrom the'selected temhlate. 





Layout Templates 
DEFAULT | 
Double Eurocard (2 Layer) | 
Double Eurocard (4 Layer) | 


Extended Double Eurocard (2 Layen) ge 


Sc EU ca Eyeh 。 





Single Euracard with Connector | 


CAProgramData\Labcenter Electron Templates\DEFAULT.LTF MN 


ーー ms 


图 2-14 不 为 工程 创建 PCB 版 文件 


4) 单 击 图 2-14 中 的 Next 按钮 ， 在 弹出 的 对 话 框 中 为 工程 选择 芯片 和 后 台 编 译 器 ， 如 
图 2-15 所 示 。 
































~ 
き New Project Wizard: Firmware Le lm 


し に) No Firmware Project 
加 Create Firmware Project 


Family Cortex-M3 














Contoller LMSS301 | 








Compiler TAR for ARI 




















Create Quick Start Files |Iy + 




















Cancel Help 


图 2-15 选择 芯片 及 后 台 编 译 器 
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5) 单 击 图 2-14 中 的 Next 按钮 ， 弹 出 创建 工程 总 览 对 话 框 ， 单 击 Finish 按钮 完成 内 烁 


灯 的 工程 创建 ， 如 图 2-16、 图 2-17 所 示 。 


a 





き New Project Wizard: Summary 





x) 





wv Schematic 
Layout 
MA Firmware 


Details 
Professional\Templates\DEFAULT. DTF 
No PCE layout 


processor on schematic 








Saving As: C:\StellarisWare_DE_301\boards\dk-lm3s301\ny_blinky. pdsprj 


Schematic template: C:\ProgramData\Labcenter Electronics\Proteus 8 


Firmware nroject: LM3S301 compiled by IAR for ARN, autoplace 





の 

















2-16 创建 工程 总 览 


6) 鼠标 右键 单 击 工程 名 ， 在 弹出 的 下 拉 菜 单 中 单 击 Add Existing 选项 为 工程 添加 startup 
_ewarm. c 启动 代码 ， 如 图 2-18 所 示 ， 给 工程 添加 闪烁 灯 和 启动 代码 。 





全 UNTITLED - Proteus 8 Professional (BETA) - Source Code 





File Source Build Edit Debug Config System Help 
口 妨 园 秘 | 仙 国 四 栓 供 国 卓 光合 : 芒 XD 了 有 R22: 邮 世 总 区 [ 
較 schematic Capture x “号 Source Code x 

















Projects maln. c 回 
ビ msss01 (U1) I 





/* Main.c file generated by Ne 






































4 Source Files 2 
因 main.c 3 
4 Linker Script Files 4 
国 LM38301 FLASH.icf 5 
网 6 
外 8 #include <iolm3s301.h> 
9 
\ 10 int main (void) 
\ 11 日 { 
12 ノ / Write your code here 
5 13 while (1) 
创建 的 工程 及 文件 14 ; 
15 return 0; 
16 } 
17 
< [niin 
?SI Studio Output 
bp | | @ NoMessages :Ready 














器 








证 


2-17 创建 的 my_blinky 工程 及 文 伯 
7) 给 空 main( ) 函数 添加 如 下 的 闪烁 灯 代 码 。 





Projects 名 
4 BEILM3S301 (V1) ~ 


4 Li 也 Import Exis 扑 File Ctrl+AltrI 
(BB|Add Existing File Ctrl+Alt+A 
4 Sol 
日 Add New File Ctrl+Alt+N 


其 Delete F Project 6 
euMrrojccs LN に ピー 
添加 启动 代码 








图 2-18 


// ネネ ボネ ネネ ポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ネネ ポポ 


#include "inc/lm3s301. h" 
int 
main( void ) 
| 
volatile unsigned long ulLoop; // 定 义 变 量 
ノ // 
// 使 能 PBO 外 接 的 LED 
// 
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SYSCTL_RCCC2_R = SYSCTL_RCGC2_GPIOB; 
// 
// 使 能 外 设 后 插入 几 个 周期 的 空 读 取 . 
// 
ulLoop = SYSCTL_RCGC2_R; 
// 
// 将 PBO(LED) 設置 妨 数 字 CPIO 输出 
// 
GPIO_PORTB_DIR_R | =0x01 ; 
GPIO_PORTB_DEN_R | =0x01; 
// 
// 死 循环 
// 
while( 1) 
| 
// 
// 点 亮 LED 
ノ / 
GPIO_PORTB_DATA_R | =0x01: 
// 
// 延 时 
// 
for( ulLoop =0julLoop <2000 ; ulLoop ++ ) 
| 

















4 

// 熄 灭 LED 

// 

GPIO_PORTB_DATA_R & = ~ (0x01); 

// 

// 延 时 

ノ // 

for( ulLoop =0;ulLoop <2000 ,ulLoop ++ ) 
| 


! 
} 


| 

8) 右键 单 击 工程 名 ， 在 弹出 的 工程 选项 设置 对 话 框 中 ， 单 击 编译 器 (Compiler) 选项 
进行 如 图 2-19 所 示 的 设置 。 

9) 右键 单 击 工程 名 ， 在 弹出 的 下 拉 菜 单 中 选择 Build Project 编译 工程 (如 图 2-20 所 
示 )， 其 编译 结果 如 图 2-21 所 示 。 

10) 搭建 内 烁 灯 程 序 测试 的 虚拟 硬件 电路 〈 如 图 2-22 所 示 )， 单 击 图 中 的 LM3S301 图 
标 ， 在 弹出 的 对 话 框 中 导入 Debug. ef 文件 〈 见 图 2-23 ) ， 然 后 按 OK 按钮 完成 .elf 格式 可 
执行 文件 的 加 载 。 
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に 
= ー- 

区 9? B23 

上 ッ ニ ーーーーーーーーーーーー ーー 

Edit |Debug (active) マ |Configuratiom Tool chaim: TAR for ARK 較 schematic Capture x ーー Snurce Code 


Contro11er Compiler 














































Projects 所 | main.c 回 
Tool [ce ~ Option Generic Option ~ 4 ass301(U1 | an- 
。 | | advanced 4 Linker S$ Import ExistingFile C 























































除 本 知 形 権 Add 目 PDM35 电 Add Existing Fi 
条 sting File C 
示 设 置 外 ， 其 他 4 source F 、4 
按 默认 设置 nta MAddNewFile Cc 
Nove Up a ェ | 
a mair name 
Move Down = 1 
"C:/StellarigWare_301" ニニ | Dete Project 
ra Delete | ーー ーーー 
"CStellarisWare_301/inc" Ii E 
人 || ee | mt Rebuild Project 
Ea F Clean Project Fi 














Option Description 





























ee a Ty er a i Project Settings 
2-19 ”编译 器 选项 配置 2-20 编译 工程 
VS Studio Output 1 ey 的 前 と 本 
TAR ANST C/C++ Compiler Wh For ARM 编译 生成 的 -elf 格式 ^ 
Copyright 1999-2012 TAR ¥ 可 执行 文件 
120 bytes of CODE memory { ~、 


Errors: none 
Warnings: none 1 

ilinkarm.exe --entry iar p# :=Cortex-M3 --output 
Compiled s fully. 

















图 2-21 闪烁 灯 工 程 的 编译 结果 


PAO/UORX PDO/PWMO 
PA1/UOTX PD1/PWM1 
PA2/SSICLK PD2 
PA3/SSIFSS PD3 
PA4/SSIRX PD4 
PA5/SSITX PD5/CCP2 

PD6/FAULT 
PB1 PD7/C0o 
PB2 PE0 
PB3 PE1 
PB4/C0- 

PB5/C1- ADC0 
PB6/CO+ ADC1 
PB7/TRST ADC2 
PCO/TCK/SWCLK ADC3 
PC1/TMS/SWDIO 
PC2TDI 
PC3/TDO/SWO 
PC4 
PC5/C1+/C1o 
PC6 
PC7 


LM3S301 


图 2-22 程序 虚拟 测试 电路 


























广 





Edit Component 
a 














Part Reference: Hidden: 区 ] 
Par walue: LM3S301 Hidden: 








Element: マ LNew | 
Program File: LM3S301\Debug\Debug.elf 图 |Ibaea = 

















Crystal Freduency p 4 (Default) [Hide All 
pcB Package 2 QFP50P900X900X1 45-48 ~ |?]|Hideal ~ 
Advanced Properties: 














Tnisgpraeehlerinap ri Zl ナ と ~ ーー 
图 2-23 导入 Debug. elf 可 执行 文件 


11) 单 击 原理 图 中 的 图标 ， 启 动 虚拟 硬件 电路 的 闪烁 灯 程 序 测试 ， 其 结果 如 图 2-24 
所 示 。 


PAO/UORX PDO/PWMO 
PA1/UOTX PD1/PWM1 
FA2/SSICLK PD2 
PA3/SSIFSS PD3 
PA4/SSIRX PD4 
PA5/SSITX PD5/CCP2 
PB0/CCPO PD6/FAULT 
PB1 PD7/C0o 
PB2 PE0 
PB3 PE1 
PB4/C0- 

PB5/C1- ADC0 
PB6/C0+ ADC1 
PB7/TRST ADC2 
PCO/TCK7SWCLK ADC3 
PC1/TMS/SWDIO 

PC2/TDI 

PC3/TDO/SWO 

PC4 

PC5/C1+/C1o 

PC6 

PC7 








器 





7 中 





2-24 闪烁 灯 程 序 的 虚拟 硬件 测试 结 细 


结论 : 从 如 图 2-24 中 的 程序 运行 结果 来 看 ， 闪 烁 灯 程 序 是 正确 的 。 采 用 Proteus 8. 1 可 
井 行 编辑 、 编 译 与 虚拟 硬件 测试 M3 程序 等 ， 不 过 本 书 不 推荐 这 种 方法 。 


基于 Proteus 8. 1 的 M3 代码 测试 


1) 将 dk -lm3s301 软件 包 的 blinky 工程 导入 到 CCS 6 中 。 
2) 将 CCS 的 输出 文件 改 成 . elf 格式 文件 ， 如 图 2-25 所 示 。 












































に 在 属 生 的 Basic Options 栏 中 
ype filter texi j i | に に に 
yP Basic Options 将 输出 文件 格式 改 成 ,elf 格式 
Resource 
General 
4 Build Configuration: |pebug [Active ] 可 | Manage Cor 
ARM Compiler 
4 ARM Linker 
Specify output file name (--output_file, -o) "blinky.elf" 
File Search Path - ー 
Advanced Options Input and output sections listed into <file> (--map_file, -m) "blinky_ccs.map" 
ARM Hex Utility [Disabled] Heap size for C/C++ dynamic memory allocation (--heap_size, -heap) 0 
Debug Set C system stack size (--stack_size, -stack) 256 





图 2-25 生成 . elf 格式 文件 


3) 编译 blinky 工程 ， 并 将 生成 的 . el 格式 文件 导入 到 Proteus 测试 电路 中 ， 如 图 2-26 
所 示 。 











六 





团 
Part Beference: U1 Hidden: | | 
Par walue: LM3S301 Hidden: 国 


Elemert a vr New 


PU blinky elf HideAl ~ 
Bl 25000000 HideAl ~ 
PCB Package: QFP5OP900%900%145-48 |2| HideAl ~ 


图 2-26 导入 .elf 格式 文件 
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4) 制作 原理 图 动画 (Schematic Animation ) , 


如 图 2-27 所 示 。 























本 站 
3 則 
J 









































iQ 面倒 口 多 自生 > DOE 




















图 2-27 








に 3 
ヨゴ 





PDO/PWMO 
PD1/PWM1 


PCOITCK/SWCLK 
PC17TMS/SWDIO 
PC27TDI 
FC37TDO/SWO 
PC4 
PC5IC1+/C10 
PC6 

PC7 


LM3S301 


上 | 作 原 理 图 动画 (Schematic Animation ) 


5) 启动 仿真 可 看 到 LED 闪烁 ， 此 时 可 按 下 暂停 键 ， 会 出 现 闪 烁 灯 的 源 代 码 ， 并 如 


图 2-28 所 示 设 置 断 点 。 





CNS Source Code - U1 


Schematic Animati on x 








CStellarisWare_301\boardsdkrlIm3s301\blinkAblinkyc 





ulLooP = SYSCTL_RCGC2_Ri 


Enab]e て he GPIO pin for the LED (PBO). 
/ enable the GPIO pin for digital funct1on. 
// て he operation of て he PB7/TRST pin. 
GPTO_PORTB_DTR_R |= OxO1: 
GPTO_PORTB_DEN_R |= Ox01: 
' Loop forever・ 


whileC1) 
t 


/ Turn on the LED- 





GPIO_PORTB_DATA_R [= OXO1: 


// Delay for a bit. 
pap = 0; ulLoop < 200000; ulLoop++) 
3 





// Turn off て he LED. 





0222 GPTO_PORTE_DATA_R &= -(Ox01): 


/ pelay for a bit. 


for (ulLoop = 0; ulLoop < 200000: ulLoop++) 








// Do a dummy read to insert a few Cycles af て er enabling the peripn 交 


set て he direction 
Care is taken 











1 
调试 工具 


动画 

















Yatch Window | Cl3 Yariables - Ui 





CN3 Registers - U1 





Watch Window 


名 X 








Name Address Value 











warch Expression 























較 2-28 











LE 图 











闪烁 灯 源 代码 、 原 至 


动画 样式 及 设置 断 点 





6) 在 观察 窗口 中 添加 变量 CPIO_PORTB_DATA， 其 步骤 为 : 右键 单 击 Watch 窗口 一 在 
弹出 的 菜单 中 选择 Add Items (By Name) 选项 一 选择 端口 B 一 选中 GPIODATA_B 一 最 后 单 击 





Done 完成 变量 的 添加 ， 如 图 2-29 所 示 。 





了 9 





Watch Window 日 x 








Name Address Value watch Expression 
+|GPIODATA_B Ox40005000 Ox00000000 




















图 2-29 添加 观察 变量 
说 明 : 此 时 GPIO_PORTB_DATA 的 值 为 0， 可 以 看 到 LED 灯 也 没 亮 ， 符 合 程 序 意 图 。 
7) 首先 单 击 调试 工具 栏 上 的 全 速 运行 按钮 ， 使 程序 在 断 点 处 停止 〈( 见 图 2-28) ， 然 后 
再 单 击 按钮 (Step Over Source Line) 或 键盘 上 的 Fl11 单 步 运 行内 烁 灯 程 序 ， 当 执行 完 断 点 处 
(0212) 的 程序 后 ，LED 灯 点 亮 ， 同 时 CPIO_PORTB_DATA 的 值 为 1， 说 明 CPIO_PORTB_ 
DATA_R | =0x01; 语句 的 确 能 使 LED 发 光 ， 程序 正 确 ， 如 图 2-30 所 示 。 


















































































wn Schematic Animation ex 
boardstdkm3s301\blnkAblnkyc MG IE 
= 
ニー 
ニー ンー 
100 
pelay for a bit. | 
p= 0: ulLoop < 200000; u]Loop++) 
n o 
、P10_PORTE DATA R & 
~\ 
Ny for a bit. | 
> 
for eng ~ oi me 直观 的 看 到 了 程序 的 运行 
ーー | きい 、 | 结果 的 观察 到 的 现象 吻合 D1 
4 区 
Watch Window | CN3 Wariables 一 3 Registers - V1 | 
Watch Window * gx | 
Name Address value wacch Expression 
[GPTODATALSY, | 0x40005000 
“< 
bp lb ll | A\ 4Messagels) : PAUSED.0.43B0189E0s 











图 2-30 单 步 运 行 的 结果 与 观察 到 的 现象 吻合 (点 亮 ) 








8) 继续 单 步 ， 当 执行 完 0222 语句 CPIO_PORTB_DATA_R &= ~ (0x01) ;后 ，LED 灯 
熄灭 且 GPIO_PORTB_DATA_R =0。 程 序 运行 结果 和 观察 的 现象 吻合 ， 该 条 语句 正确 。 如 
图 2-31 所 示 。 





-------- Turn off the LED. 
0 GPIO_PORTB_DATA_R &= -(Ox01): 


Delay for a bit. 国 











直观 的 看 到 了 程序 的 运行 + 

下 的 现 合 
| Watch Window | CMSYVar1ables - U1 WC 结果 和 观察 到 的 现象 吻合 
Watch Window Bx 


Name Address Value Watch Expression 
Ox40005000 6xoooooooo 
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图 2-31 单 步 运 行 的 结果 与 观察 到 的 现象 吻合 (熄灭 ) 
小 结 : 采用 Proteus 的 动画 调试 功能 ， 可 轻松 查找 M3 代码 中 存在 的 错误 ， 或许 比 在 真 
实 开发 板 卡 中 进行 M3 程序 的 调试 来 得 更 加 容易 ， 值 得 读者 掌握 。 
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Q の 第 少 章 @ の 
通用 异步 收发 怖 模块 (UART) 


通用 异步 接收 需 / 发 送 需 (Universal Asynchronous Receiver/Transmitter、UART) 是 设备 
间 进 行 异 步 通信 的 关键 模块 ， 用 于 数据 总 路 线 与 串 行 接口 间 串 一 并 、 并 一 串 的 转换 ， 其 优点 
在 于 通信 双方 只 需 在 相同 的 帧 格式 和 波 特 率 下 ， 无 须 共 享 时 钟 信 号 仅 赁 两 条 数据 线 就 可 进行 
数据 通信 ， 并 且 在 完成 数据 的 传输 任务 之 后 ， 可 发 出 中 断 信 和 号 或 通过 设置 标志 位 来 让 CPU 
对 其 进行 处 理 。 虽 然 UART 的 传输 速率 不 高 ( 仅 赁 两 条 数据 线 一 位 一 位 的 传输 ) ， 但 在 一 些 
由 微 处 理 器 控制 的 低速 设备 的 通信 中 却 得 到 了 广泛 的 应 用 。 

TM4C123GH6PM 必 片 具有 8 个 UART 単元 , 基 API 为 用 户 提供 了 一 组 配置 和 控制 UART 
模块 、 发 送 和 接收 数据 、 中 断 管 理 功能 的 函数 ， 其 驱动 程序 包含 在 driverlib/uart c 中 ，driv- 
erlib/uart. h 包含 了 应 用 程序 所 使 用 的 API 定义 。 


本 章 的 主要 内 容 : 


> UART 模块 简介 
> UART 固件 库 函 数 ( 见 附 录 A) 
> 例 程 























为 了 控制 本 书 的 篇 幅 ， 本 小 节 (包括 后 面 的 章节 ) 仅 给 出 TM4C123G 芯片 的 UART 模 
块 / 及 后 面 各 章 相 关 模 块 的 基本 介绍 ， 更 详细 的 内 容 请 参考 UART 通信 协议 /相关 模块 运行 机 
制 及 TI 的 技术 文档 Tiva™ TM4C123CH6PM Microcontroller DATA SHEET。 


UART 的 特点 


TM4C123GH6PM UART 模块 的 主要 特性 如 下 : 

1) 可 编程 的 波 特 率 发 生 器 ， 在 常规 模式 下 可 高 达 5 Mbit/s (16 分 频 ) 和 在 高 速 模式 最 
高 可 达 10 Mbit/s (8 分 频 ) 的 速率 。 

2) 独立 的 16 x8 发 送 FIFO 和 接收 FIFO， 可 降低 中 断 服务 程序 对 CPU 的 占用 。 

3) FIFO 长 度 可 编程 ， 包 括 提供 传统 双 缓 冲 接口 的 1 字 节 深度 的 操作 。 

4) FIFO 和 触发 深度 分 为 1/8、LM4 、 1/2 、 3/4 和 7/8 几 个 等 级 。 

$) 标准 异步 通信 位 ， 包 括 起 始 位 、 停 止 位 、 奇 偶 校 验 位 。 

6) 线 中 止 的 产生 和 检测 。 
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7) 完全 可 编程 的 串 行 接口 特性 . 

Q@5、6、7、8 个 数据 位 。 

② 偶 校 验 、 奇 校 验 、stick 或 无 奇偶 校 验 位 的 产生 /检测 。 

@ 产生 1 或 2 个 停止 位 。 

8) IrDA 串 行 红外 (SIR) 编 解 码 器 : 

① 可 编程 使 用 rrDA 串 行 红外 (SIR) 或 UART 输入 输出 。 

② 支持 rrDA SIR 编 解 码 功 能 ， 在 半 双 工 模式 时 数据 传输 速率 高 达 115. 2 Kbit/s。 

③ 支持 标准 的 3/16 和 低 功 耗 (1.41 ~2. 23 ps) 的 位 持续 时 间 。 

④ 可 编程 的 内 部 时 钟 发 生 器 ， 人 允许 对 基准 时 钟 进行 1 ~ 256 分 频 来 得 到 低 功 耗 模 式 的 位 
持续 时 间 。 

9) 支持 ISO 7816 智能 卡 的 通信 模式 。 

10) 在 UART1 模块 上 的 调制 解 调 器 流量 控制 。 

11) 支持 9 位 的 EIA -485。 

12) 标准 的 FIFO 深度 和 传输 结束 中 断 。 

13) 高 效 的 微型 直接 内 存 访问 (kDMA) 数据 传输 : 


























① 单独 的 发 送 与 接收 通道 。 
② 当 接収 FIFO 中 有 数据 时 产生 单 次 请 求 ， 当 接收 FIFO 达到 已 编程 的 触发 深度 时 会 产 
生 突 发 请 求 。 


③ 当 发 送 FIFO 中 有 空闲 单元 时 产生 单 次 请 求 ， 当 发 送 FIFO 达到 已 编程 的 触发 深度 时 
会 产生 突 发 请 求 。 
UART 的 结构 框图 
UART 的 模块 框图 如 图 3-1 所 示 。 
信号 描述 
表 3-1 列 出 了 UART 模块 的 外 部 信号 并 描述 了 每 个 信号 的 功能 。UART 信号 为 表 中 
GPIO 信号 的 复 用 功能 ， 复 位 时 默认 为 CPIO 信号 (但 UORx 与 UOTx 引 脚 默认 为 UART 功 
能 ) 。 表 中 的 “ 复 用 引 脚 /赋值 ”一 栏 列 出 了 各 UART 信和 号 所 对 应 的 CPIO 引 脚 。 可 通过 对 
GPIO 备用 功能 选择 寄存 器 (GPIOAFSEL) 中 的 AFSEL 位 置 位 来 选择 UART 功能 。 括 号 中 
的 数字 表示 必须 写 入 的 GPIO 端口 控制 寄存 器 (CPIOPCTL) 中 PMCn 位 字段 的 编码 ， 以 便 
向 指定 的 GPIO 端口 引 脚 分 配 UART 信号 。 
表 3 -1 UART 信号 (64LOEP) 





















































引 脚 名 | 引 脚 号 引 脚 类 型 | 缓冲 区 类 型 5 描述 
UORx 17 PAO (1) 1 TTL UART 模块 0 接收 
UOTx 18 PA1 (1) 0 TTL UART 模块 0 发 送 
Tg PC5 (8) ; TL _UART 模块 1 清除 发 送 调制 解 调 器 流量 控制 的 输入 
PF1 (1) 信号 
16 PC4 (8) 本 SE aa 上 ロク 
U1RTS 9 PFO (1) 0 TTL UART 模块 1 的 发 送 请 求 调 制 解 调 器 流量 控制 输出 线 





系统 时 钟 





DMA 请 求 


中 断 





标识 寄存 器 


U 





ARTPeriphID1 





UARTPeriphID2 
UARTPeriphID3 





时 钟 控 制 


UARTCC 
UARTCTL 


DMA 控 制 


UARTDMACTL 





FP 断 控制 





UARTDR 


控制 /状态 





波 特 率 时 钟 




















TxFIFO 
16x8 


UARTIBRD 
UARTFBRD 











UnTx 


UnRx 






































UARTPeriphID4 UARTRSR/ECR 16x8 

UARTPeriphIDS UARTFR 

UARTPeriphID6 

UARTPeriphID7 UARTCTL 

UARTILPR 
UART9BITAMASK 
图 3-1 UART 模块 框图 
续 ) 
引 脚 复 用 / 有 a nm 
期 勾 向 旦 ー 基 类 型 缓 ; 区 类 型 出 述 
引 脚 名 引 脚 号 引 脚 赋值 引 脚 类 型 | 缓冲 区 类 描 迷 
16 PC4 (2) 
UIRx 中 PBO (1) 1 TTL UART 模块 1 接收 
15 PC5 (2) I A 

UlTx je PB1 (1) 0 TIL UART 模块 1 发 送 
U2Rx 53 PD6 (1) I TTL UART 模块 2 接收 
U2Tx 10 PD7 (1) 0 TTL UART 模块 2 发 送 
U3Rx 14 PC6 (1) 1 TTL UART 模块 3 接收 
U3Tx 13 PC7 (1) 0 TTL UART 模块 3 发 送 
U4Rx 16 PC4 (1) I TTL UART 模块 4 接收 
U4Tx 15 PC5 (1) 0 TIL UART 模块 4 发 送 
USRx 59 PE4 (1) 1 TTL UART 模块 5 接收 
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( 续 ) 









































引用 名 | 引 肝 号 | 号 的 | 引 脚 类 型 | 缓冲 区 类 型 9 描述 
USTx 60 PES (1) 0 TTL UART 模块 5 发 送 
U6Rx 43 PD4 (1) 1 TTL UART 模块 6 接收 
U6Tx 44 PD5 (1) 0 TTL UART 模块 6 发 送 
U7Rx 9 PEO (1) I TTL UART 模块 7 接收 
U7Tx 8 PE1 (1) 0 TTL UART 模块 7 发 送 
① TTL 表示 该 引 脚 具有 与 TTL 兼容 的 电 平 。 
































注意 : 以 后 各 章 该 段 描 述 不 再 给 出 。 
UART 模块 功能 的 简要 介绍 


下 面 将 简要 介绍 UART 模块 的 功能 。 
1 发送/ 接收 逻辑 
发 送 逻 辑 对 从 发 送 FIFO 读 取 的 数据 执行 “并 - 串 ” 转 换 。 控 制 逻 辑 输 出 串 行 位 流 时 ， 
最 先 输出 起 始 位 ， 然 后 依据 控制 寄存 器 中 的 配置 顺序 输出 若干 数据 位 、 奇 偶 校 验 位 和 停止 
位 ， 如 图 3-2 所 示 。 
UnTX 1 一 2 个 
最 低 有 效 位 最 高 有 效 位 停止 位 


MN/ sme X 7 


了 奇偶 校 验 位 
起 始 位 ( 若 使 能 ) 


图 3-2 UART 数据 帧 格式 





当 检 测 到 有 效 的 起 始 脉冲 后 ， 接 收 逻辑 会 对 接收 到 的 位 流 执行 “ 串 - 并 ”转换 。 此 外 
还 会 进行 溢出 、 奇 偶 校 验 与 线路 中 止 检测 以 及 帧 错误 检查 ， 并 将 这 些 状态 随 数据 一 并 写 人 接 
收 FIFO 中 。 

2. 波 特 率 产 生 

波 特 率 除 数 (baud - rate divisor) 是 一 个 22 位 数 ， 它 由 16 位 整数 和 6 位 小 数组 成 。 波 
特 率 发 生 器 由 这 两 个 值 组 成 的 数字 来 决定 位 周期 ， 通 过 带 小 数 波 特 率 除法 器 ，UART 可以 生 
产 所 有 标准 的 波 特 率 。 波 特 率 除 数 (BRD) 和 系统 时 钟 的 关系 如 下 : 

BRD = BRDI + BRDF = SystemClock/( ClkDiv x BaudRate ) 

其 中 ，BRDI 为 BRD 的 整数 部 分 ，BRDF 为 小 数 部 分 ，SystemClock 为 系统 时 钟 ，ClkDiv 
为 16 ( 若 UARTCTL 寄存 器 中 的 HSE 位 清 零 ) 或 8 ( 若 HSE 位 被 置 位 ) 。 

6 位 小 数 部 分 的 计算 方法 为 

UARTFBRD[ DIVFRAC] =integer( BRDF * 64 +0.5) 

UART 会 产生 一 个 内 部 波 特 率 基准 时 钟 ， 其 频率 为 波 特 率 的 8/16 倍 。 该 基准 时 钟 经 过 

8/16 分 频 后 即 可 生产 发 送 时 钟 ， 并 且 它 在 接收 操作 期 间 可 用 于 检测 错误 。 
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3. 数据 传输 

接收 或 发 送 的 数据 被 保存 在 两 个 16 字 节 的 FIFO 中 ,但 接收 FIFO 中 的 每 个 字符 需 包 含 
额外 的 4 位 状态 信息 。 发 送 时 ， 数 据 先 被 写 和 人 到 发 送 FIFO 中 。 若 UART 已 被 使 能 ， 则 数据 
帧 将 按 UARTLCRH 寄存 器 中 所 设置 的 参数 启动 发 送 ， 直 到 发 送 FIFO 中 的 数据 全 部 发 送 完 
成 为 止 。 一旦 将 数据 写 人 到 发 送 FIFO 中 , UART 标志 寄存 器 中 的 BUSY 位 将 生效 ， 且 在 数 
据 发 送 期 间 一 直 保 持 有 效 。BUSY 位 仅 在 发 送 FIFO 为 空 且 包括 停止 位 在 内 的 最 后 一 个 字符 
已 从 移 位 寄存 器 中 移出 时 ， 才 会 变 为 无 效 。 这 样 ， 即 使 UART 不 再 处 于 使 能 状态 ， 也 可 能 
被 指示 为 “ 忙 ”状态 。 

在 接收 器 空闲 (UnRx 信和 号 持续 为 1) 且 数 据 输入 变 为 “ 低 电 平 ”( 收 到 起 始 位 ) 时 ， 
接收 计数 器 开始 计数 ， 并 依照 UARTCTL 寄存 器 中 HSE 位 的 配置 ， 在 Baud16 的 第 8 个 周期 
或 Baud8 的 第 4 个 周期 对 数据 进行 采样 。 

若 UnRx 信号 在 Baud16 的 第 8 个 周期 (HSE 位 清 零 ) 或 者 Baud8 的 第 4 个 周期 (HSE 
置 位 ) 仍然 为 低 电 平 ， 则 起 始 位 有 效 且 可 识别 ， 和 否则 可 忽略 该 起 始 位 。 在 检测 到 有 效 起 始 
位 后 ， 将 根据 设 定 的 数据 字符 长 度 和 UARTCTL 寄存 器 中 HSE 位 的 状态 ， 每 16 个 Baud16 周 
期 或 每 8 个 Baud8 周期 对 后 续 数 据 位 进行 一 次 采样 。 若 奇偶 校 验 模 式 被 使 能 ， 则 接着 检查 奇 
偶 校 验 位 。 数 据 长 度 和 奇偶 校 验 都 可 在 UARTLCRH 寄存 器 中 定义 。 

若 UnRx 信和 号 为 高 电 平 ， 则 可 确认 停止 位 有 效 ， 和 否则 可 指示 发 生 了 帧 错误 。 在 接收 到 一 
个 完整 的 字 时 ， 相 关 数 据 与 该 字 相 关 的 错误 位 将 一 并 被 存放 到 接收 FIFO 中 。 

4. 串 行 氏 外 (SIR) 

UART 外 设 包含 一 个 rrDA 串 行 红外 编 /解码 器 模块 。IrDA SIR 模块 的 功能 可 在 异步 
UART 数据 流 和 半 双 工 串 行 SIR 接口 之 间 转 换 。SIR 模块 的 作用 仅 为 向 UART 提供 数字 编码 
输出 和 解码 输入 ， 不 会 在 片上 执行 任何 模拟 信号 处 理 。 在 使 能 SIR 模块 后 ， 该 模块 将 用 
UnTx 与 UnRx 引 脚 执行 SIR 协议 ， 这 些 信号 应 与 红外 收发 器 连接 来 完成 DA SIR 的 物理 
层 连 接 。SIR 模块 虽 可 接收 和 发 送 数据 ， 但 只 能 以 半 双 工 方式 进行 红外 通信 ， 故 而 不 可 同 
时 进行 接收 和 发 送 操作 ， 并 且 rrDA SIR 物理 层 规定 在 发 送 和 接收 之 间 至 少 存在 10 ms 的 
延迟 。 

SIR 模块 有 以 下 两 种 工作 模式 : 

1) 在 标准 DA 模式 下 ， 输 出 引 脚 上 发 送 的 逻辑 0 电 平 为 高 脉冲 ， 其 位 宽 为 所 选 波 特 率 
位 周期 的 3Z16 ， 而 发 送 的 逻辑 1 电 平 则 是 一 个 静态 低 电 平 信号 。 这 些 电 平 控制 红外 发 送 器 
的 驱动 装置 ， 着 0 电 平 便 发 送 光 脉 冲 。 在 接收 端 ， 接 收 到 的 光 脉 冲 连 接 到 接收 器 的 光敏 晶体 
管 基 极 ， 这 样 将 使 输出 驱动 为 低 电 平 ， 并 将 UART 输入 引 脚 拉 低 。 

2) 在 rDA 低 功 耗 模式 下 , 変更 UARTCR 寄存 器 中 的 相应 位 后 ， 会 将 发 送 红 外 脉冲 
的 脉 宽 置 为 内 部 产生 的 rrLPBaud16 信号 周期 的 3 倍 (在 标 称 频率 为 1.8432 MHz 时 为 
1.63 ps) 。 

S. 支持 ISO 7816 智能 卡 的 通信 模式 

UART 为 与 ISO 7816 智能 卡 之 间 的 通信 提供 了 一 些 基 本 支持 。 当 UARTCTL 寄存 器 中 的 
SMART 位 置 位 时 ，UnTx 信号 将 被 作为 位 时 钟 信号 ， 而 UnRx 信号 则 用 于 连接 到 智能 卡 的 半 
双 工 通信 线路 。 而 CPIO 信和 号 可 用 于 向 智能 卡 发 送 复位 信号 ， 其 余 智 能 卡 信号 应 由 系统 设计 
提供 ， 在 该 模式 下 的 最 大 时 钟 速 率 为 系统 时 钟 的 1/16。 
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在 使 用 ISO 7816 模式 时 ，UARTLCRH 寄存 器 必须 配置 为 发 送 8 位 数据 字 NN 字段 
6: 5 配置 为 0x3 ) ， 带 偶 校 验 ( 即 PEN 与 EPS 位 置 位 ) 。 在 该 模式 下 ，UART 将 自动 使 用 2 
个 停止 位 ， 而 忽略 UARTLCRH 寄存 器 中 的 STP2 位 。 

若 在 发 送 期 间 检 测 到 奇偶 校 验 错误 ，UnRx 将 在 第 二 个 停止 位 期 间 被 拉 至 低 电 平 。 在 这 
种 情况 下 ，UART 将 终止 发 送 、 刷 新 发 送 FIFO 中 的 所 有 数据 ， 同 时 产生 一 个 奇偶 校 验 错误 
中 断 来 让 软件 检测 到 该 问题 ， 并 重新 发 送 受 影 响 的 数据 。 注 意 ，UART 不 支持 该 种 情况 的 自 

6. 支持 调制 解 调 器 握手 信和 号 

下 面 将 介绍 在 UART 作为 数据 终端 设备 (DTE) 或 数据 通信 设备 (DCE) 连接 时 ， 如 
何 配置 UART1 和 使 用 调制 解 调 器 的 流 控 制 信号。 一 般 情 况 下 ， 调 制 解 调 器 为 DCE ， 而 连接 
到 调制 解 调 器 的 计算 设备 为 DTE。 

(1) 发 信号 

根据 UART 是 作为 DCE 还 是 作为 DTE 的 不同 , UARTI 所 提供 的 状态 信号 也 会 有 所 
不 同 。 

1) 当 作 为 DTE 时 ,调制 解 调 器 的 流 控 信号 定义 如 下 : 

① U1CTS 允 许 发 送信 号。 


② U1RTS 请 求 发 送信 号。 
2) 当 作 为 DCE 时 ， 调制解调器 的 流 控 信号 定义 如 下 .: 


① U1CTS 请 求 发 送信 和 号。 


② U1RTS 人 允许 发 送信 和 号。 

(2) 流 控 制 

流 控制 既 可 通过 便 件 也 可 通过 软件 来 实现 。 下 面 将 分 别 描述 这 两 种 方法 。 

1) 硬件 流 控 制 (RTS/CTS) 。 两 个 设备 之 间 的 硬件 流 控 制 是 由 ULRTS 输 出 端 连接 到 接收 
设备 的 “清除 发 送 (Clear - To - Send)” 输 入 端 实现 的 ， 以 及 将 “请 求 发 送 ”的 输出 端 连 
接 到 接收 设备 上 的 ULCTS 输 入 端 上 。 由 ULCTS 输 入 端 控制 发 送 器 ， 而 且 只 有 在 UL1CTS 输 入 端 
有 效 时 发 送 器 才能 发 送 数据 。U1RTS 输 出 信号 可 指示 接收 FIFO 的 状态 ， 且 Ul1CTS 将 一 直 保 
持 有 效 ， 直 到 达到 预 设 的 电 平 ， 此 时 接收 FIFO 中 已 无 多 余 空间 可 用 。UARTCTL 寄存 器 中 的 
CTSEN 位 和 RTSEN 位 指定 流 控 模式 ， 见 表 3-2。 

表 3-2 流 控 制 模式 



















































































CTSEN RTSEN 描 。 迷 
1 1 使 能 RTS 和 CTS 流量 控制 
0 只 使 能 CTS 流量 控制 
0 1 只 使 能 RTS 流 控制 
0 0 禁止 RTS 和 CTS 流量 控制 





注意 : 当 RTSEN 为 1 时 ， 软 件 无 法 通过 UARTCTL 寄存 器 的 请 求 发 送 (RTS) 位 来 修改 
ULRTS 的 输出 值 ， 并 且 应 忽略 RTS 位 的 状态 。 
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2) 软件 流 控 制 ( 调制解调器 的 状态 中 断 )。 通 过 使 用 中 断 来 指示 UART 的 状态 ， 从 而 
完成 两 台 设 备 间 的 软件 流 控制 。 使 用 UARTIM 寄存 器 中 的 第 3 位 ， 以 便 为 U1CTS 信 号 发 出 中 
断 。 可 使用 UARTRIS 寄存 器 和 UARTMIS 寄存 器 查看 原始 中 断 和 屏蔽 中 断 的 状态 ， 并 可 通 
过 UARTICR 寄存 器 来 清除 这 些 中 断 。 

7. 9 位 UART 模式 

在 9 位 模式 下 ，UART 可 用 于 多 点 通信 ， 并 通过 UART9BITADDR 寄存 器 中 的 9BITEN 
位 来 使 能 。 主 机 可 通过 其 地 址 (或 一 组 地 址 ) 以 及 一 个 地 址 字 节 限定 符 (地 址 字 ) 与 某 个 
特殊 的 从 机 进行 通信 。 如 果 所 有 地 址 限定 符 的 从 机 检查 置 位 ， 可 通过 比较 接收 到 的 字 节 与 预 
编程 的 地 址 ， 如 果 地 址 匹配 ， 那 么 将 接收 或 发 送 更 多 的 数据 ; 如 果 地 址 不 匹配 ， 将 丢弃 该 地 
址 字 节 和 后 续 的 数据 字 节 。 可 用 UART9BITADDR 寄存 器 来 预定 义 地 址 来 匹配 所 接收 的 字 
节 ， 以 及 使 用 UART9BITAMASK 寄存 器 中 的 地 址 屏蔽 ， 让 匹配 扩展 到 一 组 地 址 ， 上 默认 时 ， 
UART9BITAMASK 为 0xFF， 意 味 着 只 有 指定 的 地 址 可 匹配 (注意 , 在 9 位 模式 下 ， 接 收 需 
操作 无 奇偶 校 验 模式 ) 。 

在 未 找到 匹配 时 ， 清 零 的 第 9 位 和 其 余数 据 字 节 将 被 丢弃 ; 如果 找到 匹配 ， 将 会 向 
NVIC 发 出 一 个 中 断 以 便 进 一 步 的 动作 ， 清 零 的 第 9 位 和 后 续 数 据 字 节 将 被 保存 到 FIFO 中 。 
若 此 时 使 能 了 wDMA 和 /或 FIFO 操作 ， 软 件 可 屏 项 该 中 断 ， 而 无 须 处 理 器 干预 。9 位 模式 
的 所 有 传送 操作 都 为 数据 字 节 且 第 9 位 被 清 零 。 软 件 可 将 奇偶 校 验 设置 为 粘着 奇偶 校 验 ， 
对 某 个 字 节 使 能 奇 校 验 ， 以 改写 置 位 的 第 9 位 。 欲 使 发 送 时 间 与 奇偶 校 验 设置 匹配 ， 可 将 
地 址 字 节 作为 单 次 传输 而 不 是 突 发 传输 。 由 于 发 送 FIFO 并 不 含 地 址 /数据 位 ， 因 此 软件 应 
使 能 相应 的 地 址 位 。 

8. FIFO 操作 

UART 具有 2 个 16 x8 的 FIFO: 其 中 一 个 用 于 发 送 ， 而 另 一 个 用 于 接收 。 这 两 个 FIFO 
都 可 通过 UART 数据 寄存 器 (UARTDR) 进行 访问 。UARTDR 寄存 器 的 读 操作 将 返回 一 个 
12 位 的 值 ， 包 括 8 个 数据 位 和 4 个 错误 标志 ， 而 写 操 作 则 将 8 位 数据 保存 到 发 送 FIFO 中 。 

复位 后 ， 两 个 FIFO 均 处 于 禁止 状态 ， 并 作为 1 字 节 深 的 保持 寄存 器 。 可 通过 对 UAR- 
TLCRH 寄存 器 中 的 FEN 位 置 位 来 使 能 这 两 个 FIFO。 

通过 UART 标志 寄存 器 (UARTFR) 和 UART 接收 状态 寄存 器 (UARTRSR ) 来 监控 
FIFO 的 状态 ， 对 于 空 、 满 和 溢出 条 件 则 由 硬件 进行 监控 。UARTFR 寄存 器 包含 空 和 满 的 标 
志 (TXFE、TXFF 、RXFE 和 RXFF 位 ) ， 而 UARTRSR 寄存 器 则 通过 OF 位 来 指示 溢 出 状 
态 。 如 果 FIFO 被 禁止 ， 空 和 满 的 标志 由 1 字 节 深 的 保持 寄存 器 的 状态 设置 。 

FIFO 产生 中 断 的 触发 点 是 通过 UART 中 断 FIFO 深度 选择 寄存 器 (UARTIFLS) 来 控制 。 
可 将 两 个 FIFO 分 别 配置 为 在 不 同 的 深度 触发 中 断 。 可 供 选 择 的 配置 包括 1/8 、1/4 、1/2 、 
3/4 和 7/8， 例 如 ， 给 接收 FIFO 选择 了 1/4, 则 UART 会 在 接收 4 个 数据 字 节 之 后 产生 接收 
中 断 。 未 复位 时 ， 两 个 FIFO 都 被 配置 为 在 1/2 的 深度 触发 中 断 。 

9. 中 断 

在 出現 以下 情況 時 , UART 将 产生 中 断 : 

① 溢出 错误 。 

② 中 止 错误 。 

③ 奇偶 校 验 错误 。 
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④ 帧 错误 。 

⑤ 接收 超时 。 

@ 发 送 ( 当 満足 UARTIFLS 寄存 器 中 的 TXIFLSEL 位 所 定义 的 条 件 时 ， 或 对 UARTCTL 
寄存 器 的 EOT 位 置 位 且 所 有 发 送 数据 的 最 后 1 位 已 从 串 行 移 位 寄存 器 移出 时 ) 。 

⑦ 接收 ( 当 満 足 UARTIFLS 寄存 器 中 的 RXIFLSEL 位 所 定义 的 条 件 时 ) 。 

在 所 有 中 断 事件 发 送 到 中 断 控 制 器 之 前 ， 先 行 对 其 执行 “逻辑 或 ”操作 ， 因 此 UART 
一 次 只 能 向 控制 器 发 送 一 个 中 断 请 求 。 通 过 读 取 UART 屏蔽 中 断 状态 寄存 器 (UARTMIS) , 
软件 可 在 一 个 中 断 服务 例 程 中 处 理 多 个 中 断 事 件 。 

对 UART 中 断 屏蔽 寄存 器 (UARTIM) 中 的 相应 IM 位 置 位 ， 可 定义 能 触发 控制 器 级 别 
的 中 断 事件 。 如 果 不 使 用 中 断 ， 原 始 中 断 状态 在 UART 原始 中 断 状态 寄存 器 ( UARTRIS) 
中 总 是 可 见 的 。 向 UART 中 断 清除 寄存 器 (UARTICR) 中 的 相应 位 写 1 即 可 清除 该 中 断 。 

当 接 收 FIFO 不 为 空 时 ， 接 收 超时 中 断 有 效 ， 在 32 位 周期 内 (在 HSE 位 清 零 时 ) 或 在 
64 位 周期 内 ( 当 HSE 位 置 位 时 ) 不 再 接收 数据 。 接 收 超时 中 断 既 可 自动 清除 ( 当 读 出 
FIFO 或 保持 寄存 右 中 的 所 有 数据 ， 使 FIFO 变 为 空 状 态 时 ) ， 也 可 将 UARTICR 寄存 器 的 相 
应 位 置 位 来 手动 清除 。 

1) 当 发 生 下 列 事件 时 ， 接 收 中 断 的 状态 将 被 改变 . 

① 如果 FIFO 使 能 且 接 收 FIFO 达到 设 定 的 触发 点 ，RXRIS 位 被 置 位 。 当 从 接收 FIFO 中 
读 取 的 数据 低 于 触发 点 时 ,将 自动 清除 接收 中 断 ， 或 通过 向 RXIC 位 写 1 来 手动 清除 中 断 。 

② 如果 FIFO 被 禁止 (有 一 个 位 置 的 深度 ) 且 接 收 到 的 数据 已 填充 该 位 置 ，RXRIS 位 
将 被 置 位 。 通 过 对 接收 FIFO 执行 一 次 读 取 操作 来 清 零 接 收 中 断 ， 或 通过 向 RXIC 位 写 1 来 
清 除 中 断 。 

2) 当 发 生 下 列 事件 时 ， 发 送 中 断 的 状态 将 被 改变 . 

① 如果 FIFO 被 使 能 且 发 送 FIFO 达到 设 定 触发 点 ，TXRIS 位 将 被 置 位 。 发 送 中 断 的 产 
生 依据 触发 点 的 高 低 ， 因 此 在 FIFO 中 写 入 的 数据 必须 超过 该 设 定 的 触发 点 ， 否 则 不 会 再 产 
生发 送 中 断 。 当 向 发 送 FIFO 中 写 入 的 数据 大 于 触发 点 时 来 清除 发 送 中 断 ， 或 通过 向 TXIC 
位 写 1 来 清 除 中 断 。 

② 如果 FIFO 被 禁止 (有 一 个 位 置 的 深度 ) 且 无 数据 存在 于 发 送 器 的 单个 位 置 ，TXRIS 
位 将 被 置 位 。 可 通过 向 发 送 FIFO 中 执行 一 次 写 和 人 操作 来 清除 发 送 中 断 ， 或 通过 向 TXIC 位 
写 1 来 清 除 中 断 。 

10. 回 送 操作 

可 对 UARTCTL 寄存 器 中 的 LBE 位 置 位 ， 来 使 UART 进入 内 部 回 送 模式 ， 以 便 UART 进 
行 诊断 和 调试 。 在 回 送 模式 下 ，UnTx 输出 端 发 送 的 数据 将 被 UnRx 输入 端 接收 。 

注意 : 需 先行 对 LBE 位 置 位 ， 再 使 能 UART。 

11. DMA 操作 

UART 向 LDMA 控制 器 接口 提供 独立 的 发 送 和 接收 通道 。UART 的 DMA 操作 通过 
UART DMA 控制 寄存 器 (UARTDMACTL) 来 使 能 。 当 DMA 操作 使 能 后 ， 在 相应 的 FIFO 传 
输 数 据 时 ，UART 将 向 接收 通道 或 发 送 通 道 发 出 DMA 请 求 。 对 于 接收 通道 ， 如 果 接 收 FIFO 
中 含有 数据 ， 就 将 发 出 单 次 传输 请 求 。 如 果 接 收 FIFO 中 的 数据 量 达 到 或 超过 UARTIFLS 寄 
存 器 中 配置 的 FIFO 触发 深度 ， 则 会 发 出 突 发 传输 请 求 。 对 于 发 送 通道 ， 只 要 发 送 FIFO 中 
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至 少 有 一 个 空位 ， 就 将 发 出 单 次 传输 请 求 。 如 果 发 送 FIFO 中 所 含 的 字符 少 于 FIFO 触发 深 
度 ， 则 会 发 出 突 发 请 求 。 并 且 pDMA 控制 器 将 根据 DMA 通道 的 配置 自动 处 理 单 次 和 突 发 
DMA 传输 请 求 。 

如 果 使 能 接收 通道 的 DMA 操作 ， 需 对 DMA 控制 寄存 器 (UARTDMACTL) 中 的 RXD- 
MAE 位 进行 置 位 。 如 果 使 能 发 送 通 道 的 DMA 操作 , 需 対 UARTDMACTL 寄存 器 中 的 TXD- 
MAE 位 进行 置 位 。 还 可 将 UART 配置 为 在 发 生 接收 错误 时 ， 使 接收 通道 停止 使 用 DMA。 如 
果 对 UARTDMACR 寄存 器 的 DMAERR 位 进行 了 置 位 且 发 生 接收 错误 ， 则 会 自动 禁止 DMA 
接收 请 求 。 如 遇 到 此 种 情况 可 通过 清除 相应 的 UART 错误 中 断 来 清除 。 

若 使 能 了 wpDMA, 回 pDMA 控制 器 将 会 在 传输 完成 后 自动 触发 中 断 。 在 UART 操作 中 
使 用 了 中 断 且 使 能 了 DMA， 那 么 在 UART 中 断 处 理 函 数 中 必须 包含 对 pDMA 完成 中 断 的 
处 理 。 


























下 面 将 简要 介绍 UART 固件 库 的 结构 和 常用 的 几 个 API 函数 及 其 基本 操作 ， 完 整 UART 
国 件 库 函 数 的 参数 定义 、 功 能 描述 等 请 参看 书后 附录 A 第 3 章 附 录 。 


UART 固件 库 结 构 


UARTAPI 一 般 包 含 四 个 功能 组 : 

① 配置 和 控制 。 

② DMA 操作 。 

③ 发 送 和 接收 。 

④ 中 断 处 理 。 

1) 由 以 下 函数 完成 UART 的 配置 和 控制 : 
> UARTConfigGetExpClk( ) 。 

> UARTConfisSetExpClk( ) 。 

> UARTDisable( ) 。 

> UARTPnable( ) 。 

> UARTParityModeGet( ) 。 

> UARTParityModeSet( ) 。 

2) 由 下 列 函 数 使 能 或 禁止 DMA 操作 : 
> UARTDMAEnable( ) 。 

> UARTDMADisable( ) 。 

3) 由 以 下 函数 来 实现 UART 的 发 送 和 接收 : 
> UARTCharGet( ) 。 

> UARTCharGetNonBlocking( ) 。 

> UARTCharPut( ) 。 

> UARTCharPutNonBlocking( ) 。 

> UARTBreakCtl( ) 。 
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> UARTCharsAvail( ) 。 

> UARTSpaceAvail( ) 。 

4) UART 中 断 由 以 下 也 数 实现 . 
> UARTIntClear( ) 。 

> UARTIntDisable( ) 。 

> UARTIntEnable( ) 。 

> UARTIntRegister( ) 。 

> UARTIntStatus( ) 。 

> UARTIntUnregister( ) 。 


UART 的 基本 操作 


(1) 初始 化 UART 
1) 使 能 UART 外 设 ， 如 : 





SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 


2) 设置 RX/TX 引 脚 作为 UART 引 脚 , 如 : 


GPIOPinConfigure(CPIO_PAO_UORX ) ; 
GPIOPinConfigure(CPIO_PA1_UOTX ) ; 
CPIOPinTypeUART(CPIO_PORTA_BASE ,CPIO_PIN_0 | GPIO_PIN_1) ; 


3) 配置 UART 参数 ， 如 . 





ROM_UARTConfigSetExpClk ( UARTO_BASE, ROM_SysCtlClockGet( ) ,115200 , 
UART_CONEIC_WLEN_S | UART_CONEIC_STOP_ONE | 
UART_CONEFIC_PAR_NONE ) ) ; 

4) 配置 UART 的 其他 特性 ( 如 中 断 、FIFO) 。 

(2) 发 送 /接收 一 个 字符 

1) 单 寄 存 器 用 于 发 送 /接收 。 

2) 在 驱动 库 中 的 阻塞 / 非 阻塞 函 数 ， 如 . 


UARTCharPut( UARTO_BASE, a’ ) ; 

newchar = UARTCharGet( UARTO_BASE ) ; 
UARTCharPutNonBlocking( UARTO_BASE, ‘a’ ) ; 
newchar = UARTCharGetNonBlocking( UARTO_BASE ) ; 


下 面 将 以 TI 提供 的 例 程 为 例 来 介绍 UART 固件 库 的 使 用 、 编 程 及 IAR 开发 软件 的 使 用 
方法 (该 例 程 是 自 收 -自发 ,不 需要 外 接 其 他 硬件 ) 。 


1) uart_echo. c 程序 介绍 。 





// ネネ ボネ ネネ ボ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ネギ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ 


50 


//! 文件 名 :uart_echo. c 

//! 来 源 :TI 例 程 

//! 功能 描述 : 

/! 使用 UART 实现 文字 回 显 
//! UART 配置 为 : 波 特 率 =115 ,200 、8 个 数据 位 -无 校 验 位 -1 个 停止 位 
/! 通过 虚拟 串口 (USB 口 ) ,将 从 UART 接收 到 的 所 有 字符 回 送 到 电脑 屏幕 上 
//! 练习 IAR 开发 软件 的 使 用 
//! 该 例 程 为 版 本 号 为 2. 0.1. 11577 固件 包 中 的 一 个 例 程 (用 于 EK - TM4C123GXL 开发 板 ) 


// ネネ ボネ ネネ ポ ネネ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ネネ ポポ 










































































#include < stdint. h > 

#include < stdbool. h > 

#include "inc/hw_ints. h" 

#include "inc/hw_memmap. h" 

#include " driverlib/ debug. h" 

#include " driverlib/fpu. h" 

#include " driverlib/ gpio. h" 

#include " driverlib/interrupt. h" 

#include " driverlib/pin_map. h" 

#include " driverlib/rom. h" 

#include " driverlib/sysctl. h" 

#include " driverlib/uart. hy" 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 
// 当 驱动 程序 库 遇 到 错误 时 调用 的 错误 处 理 程序 

クキ キキ キキ キキ キキ キキ キキ キキ エキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 
#ifdef DEBUC 


void 


























_ error_ (char * pcFilename ,uint32_t ui32Line ) 
| 


| 
#endif 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ネネ ポポ ボネ 


//UART 中 断 处 理 器 


ノノ 水 玉米 米 米 炒米 玉米 米 米 米 米 炒米 炒米 炒米 炒米 炒米 炒米 米 米 炒米 炒米 炒米 米 沙洲 炒米 米 洲 米 炒米 炒米 玉米 炒米 炒米 炒米 炒米 米 米 米 
void 
UARTIntHandler( void ) 


uint32_t ui32Status ; 








XY 

// 获 取 中 断 状态 

// 

ui32Status = ROM_UARTIntStatus( UARTO_BASE ,true ) ; 
// 

// 清 除 有 效 中 断 

ノ / 

ROM_UARTIntClear( UARTO_BASE , 32Status ) ; 
ノ / 

/判断 接收 FIFO 中 是 否 有 字符 存在 

// 


う 7 


while(ROM_UARTCharsAvail(UARTO_BASE) ) 
| 
LL 
// 从 UART 读 取 下 一 个 字符 ,并 将 其 写 回 到 UART 上 
ノ / 
ROM_UARTCharPutNonBlocking( UARTO_BASE , 
ROM_UARTCharCetNonBlockine( UARTO_BASE ) ) ; 
// 
// 以 闪烁 的 LED 灯 用 来 显示 字符 转移 正在 发 生 
// 
GPIOPiIn Write( GPIO_PORTF_BASE,GPIO_PIN 2,GPIO_PIN 2) ; 
ノ / 
// 延 迟 1ms( 每 个 SysCDelay 大 约 是 3 个 时 钊 
// 
SysCtlDelay( SysCtlClockGet( )/(1000 * 3)); 
// 
// 关 闭 LED 
// 
GPIOPinWrite( GPIO_PORTF_BASE, GPIO_PIN_2,0) ; 








HU 
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1 
1 


// ネネ ボネ ネネ ポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ 


// 向 UART 发 送 一 个 字符 是 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ネネ ポポ 


Ud 





void 
UARTSend( const uint8_t * pui8 Buffer,uint32_t ui32Count) 
| 
A 
// 等 待 多 个 字符 发 送 完 成 
// 
while( ui32Count - - ) 
| 
メ / 
// 写 下 一 个 字符 到 UART 
ノ / 
ROM_UARTCharPutNonBlockine( UARTO_BASE , * pui8Buffer ++ ) ; 


| 


ノノ 六 六 米 米 米 闵 米 米 米 米 米 米 米 六 玉米 米 米 六 六 玉米 六 六 玉米 六 六 玉米 六 米 六 六 玉米 六 六 六 玉米 六 六 玉米 六 六 六 六 玉米 六 六 玉米 六 六 六 
// 该 例 程 将 示范 如 何 向 UART 发 送 一 个 字符 串 数据 


// ネネ ボネ ネネ ボネ ネネ ポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ネネ ポポ 





int 
main( void ) 
| 
ノ / 
// 使 能 扩展 (lazy ) 堆栈 的 中 断 处 理 程序 
// 这 将 允许 在 中 断 服务 程序 间 使 用 浮 点 指令 ,但 需 花 费 额外 的 堆栈 空间 
ZL 
ROM_FPUEnable( ) ; 



































ROM_FPULazyStackingEnable( ) ; 

// 

// 设 置 直接 从 晶体 运行 的 时 钟 

// 

ROM_SysCtlClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_16MHZ) : 





// 

// 使 能 板 载 用 于 LED 灯 的 GPIO 端口 

// 

ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_CPIOF ) ; 

// 

// 使 能 PF2 引 脚 来 点 亮 蓝 色 LED 灯 

// 

ROM_GPIOPinTypeGPIOOutput( GPIO_PORTF_BASE,GPIO_PIN 2) ; 

// 

// 使 能 所 使 用 的 外 设 

ノ // 

ROM_SysCHPeripheralEnable( SYSCTL_PERIPH_UART0O ) ; 

ROM_SysCtIPeripheralEnable( SYSCTL_PERIPH_CPIOA ) ; 

Xp 

// 使 能 处 理 器 中 断 

// 

ROM_IntMasterEnable( ) ; 

ノ // 

// 将 GPIO AO 与 Al 引 脚 设置 为 UART 功能 

ノ / 

GPIOPinConfigure( CPIO_PA0_UORX) ; 

GPIOPinConfigure( CPIO_PA1_UOTX ) ; 

ROM_CPIOPinTypeUART(GPIO_PORTA_BASE,GPIO_PIN_0 | GPIO_PIN_1 ) ; 

// 

// 配 置 UART : 波 特 率 为 115 ,200 、8 个 数据 位 -无 校 验 位 -1 个 停止 位 (8 -N -1) 

// 

ROM_UARTConfigSetExpClk ( UARTO_BASE, ROM_SysCtlClockGet( ) ,115200, 
(UART_CONFIG_WLEN_8 | UART_CONFIG_STOP_ONE | 
UART_CONFIG_PAR_NONE) ) ; 























// 

// 使 能 UART 中 断 

// 

ROM_IntPnable(INT_UARTO ) : 
ROM_UARTIntPnable(UARTO_BASE,UART_INT_RX | UART_INT_RT) : 
ZL 

// 提 示 要 输入 的 文字 

// 

UARTSend( (uint8_t * )"\033[2JEnter text: " ,16 ) ; 
// 

// 无 限 循环 ,以 便 通 过 UART 回 显 数据 

// 

while(1) 








| 
2) 在 C:\ti\TivaWare_C_Series - 2. 0. 1. 11577 \examples \boards \EK - TM4C123GXL 目录 
下 ， 导 入 IAR EK - TM4C123GXL 工作 空间 ， 如 图 3-3 所 示 。 
3) 如 果 是 首次 使 用 IAR， 一 般 需 要 对 驱动 函数 库 进 行 一 次 编译 ， 如 图 3-4 所 示 。 
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(の 〉 计算 机 ， 本 計 識 量 (C) ょ ti は TvaWare.C Sered” 日 回 el-tm4c123qml ドコ 
SD i | -ey 
~ FD usbib- Options.… 
a [ivaWare C Series ..J の ci 者 上 是 還 bitbana Make 
Em 田 
| (TivaWare_C_Series-2.0.1.1157 1 印 blinky - OF 

ek-tm4c123gxl 如 加 freeros Rebuild Al 

“| ek-tm4c123gx EE 一 

3-3 导入 IAREK - TM4C123GXL 工作 空间 图 3-4 ”编译 驱动 函数 库 











4) 激活 并 编译 uart_echo 工程 ， 如 图 3-5 所 示 。 
5) 在 自 建 UART 类 工程 时 ， 需 添加 符号 定义 到 c/c + + Compiler 选项 中 ， 如 图 3-6 
所 示 。 


Workspace x 
uart_echo -Debug be 


Files に 

+ DD himers- Debuq 
Lo 
HH Libraries 


か アー ロー の 



























































































































































| 0 
和 Output A Options for node "uart_echo" だ 
ーー 是 uart_echomap +nt 二 
本 目 号 sn Categary: # 
让 二 ゴ コ 日 【 モミ Multr-file Compilation 
トロ 2 Dutput | の General Options 到 SN MS の 
| a ROM_FPOEnaW eceee な 
| ーー 2 四 ou TM EGRE コ ド 
っ Messages 8 Ti っ 
Linking | ミ 
uart_echo out 编译 生成 .bin 格 式 FP 
Converting 的 可 执行 文件 + Defined synbols: |tone per _ [a 
Ewarm と 
Total number of errors: 0 TI Stellaris # 
Total number of warnings: 0 4 Macraigor TARGET_IS_BLIZZARD_RB 3 
图 3-5 uart_echo 工程 的 编译 结果 图 3-6 在 创建 与 UART 有 关 的 工程 


























时 需 添加 符号 定义 


6) 在 程序 中 如 果 有 中 断 处 理 孔 数 ， 需 将 其 添加 到 中 断 向 量 表 中 。 如 本 例 程 中 的 UAR- 
TIntHandler( ) 函数 ， 首 先 需 在 startup_ewarm. c 中 声明 为 外 部 函数 ， 然 后 将 中 断 处 理 函 数 添 
加 到 该 文件 的 中 断 向 量 表 中 ， 如 图 3-7 所 示 。 
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J Pd 


// External declarats for the interrupt handler used by the application 






extern void UARTIntHandler(void); 


声明 中 断 处 理 函 数 为 外 部 函数 





// Reserved 

// Reserved 
0, // Reserved 
IntDefaultHandler, // SVCall handler 
IntDefaultHandler,  // Debug monitor handler 


IntDefaultHand 将 中 断 处 理 函数 添 
IntDefaultHand] 却 到 中 断 向 量 表 中 








V handler 





で 
TntDefau1tHand1e LD 
IntDefaultHandler, // GPIO Port E 
UARTIntHandler, // UARTO Rx and Tx 
IntDefaultHandler, UARTL,RX and Tx 
1 mm he | 





图 3-7 将 中 断 处理 函 数 添加 到 中 断 向 量 表 中 的 方法 











7) 测试 。 

① 单 击 工具 栏 中 的 少 按 钮 ， 将 编译 生成 的 . bin 文件 下 载 到 EK - TM4C123GXL 板 中 , 
然后 单 击 工具 栏 中 的 风 按 钮 ， 让 程序 在 EK - TM4C123GXL 板 中 全 速 运行 。 

② 打开 PuTTY (有 关 PuTTY 的 配置 请 参看 第 1 章 相 关内 容 ) ， 然 后 按 开 发 板 上 的 复位 




















按钮 ， 显 示 的 程序 测试 结果 如 网 3-8 所 示 。 
gp cov7 - PuTTY EX 








图 3-8 在 PuTTY 中 显示 “提示 输入 文本 ” 


@ 再 在 图 3-8 绿色 光标 处 ， 从 键盘 输入 “It is a test for UART1!!” 文 本 ， 并 且 在 输入 
文本 时 蓝 色 的 LED 灯 不 断 闪 烁 ， 程 序 在 EK - TM4C123GXL 板 中 的 运行 结果 如 图 3-9 
所 示 。 














中 coM7 - PuTTY | 回 屋久 














图 3-9 回 送 程序 的 测试 结果 


从 图 3-9 中 可 以 看 到 ， 通 过 UART 接收 到 的 文本 “It is a test for UART!!” 被 回 送 到 
UART 上 显示 了 出 来 ， 这 就 验证 了 回 送 程序 的 正确 性 。 

④ 也 可 以 用 串口 助手 来 调试 UART 回 送 例 程 ， 其 操作 步骤 如 下 : 

首先 将 UARTSend( (uint8_t * )"\033[J2Enter text: " ,18) 改 为 UARTSend( (uint8_t * )" 
输入 文本 ;" ,18) ; 然后 全 速 运行 程序 ， 让 UART 向 串口 助手 发 送 “ 输 入 文本 :” 文 本 ;最 后 
在 串口 助手 的 “发 送 区 ”向 UART 发 送 “This is a test!” 文 本 ， 同 时 可 观察 到 蓝 色 LED 灯 
的 内 烧 ， 如 图 3-10 所 示 。 
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串口 调试 助 
F 向 UART 




































































区 (his is a test! 
































动 发 送 周期 iooo 毫秒 选择 发 送 文件 | | 还 没有 选择 文件 
nn | STATUS: COM7 Opened 115200 Wone 8 1 [Rx:1797 Ir:2216 





























图 3-10 使 用 串口 助手 测试 ARUT 回 送 程 序 


有 兴 Ne 以 在 造 名 “while(ROM_UARTCharsAvail(UARTO_BASE) ) ”处 放置 一 
个 断 点 ， 然 后 采用 单 步 运行 的 方式 ， 观 察 串 口 助手 向 UART 发 送 文本 数据 的 情况 。 
⑤ 没有 EK -TM4C123GXL 板子 的 读者 ， 可 用 Proteus 对 dk - lm3s301 软件 包 中 的 uart_ 
echo 工程 进行 测试 ， 请 参考 配套 资源 中 的 第 3 章 内 容 。 在 Proteus 中 的 测试 结果 如 图 3-11 所 
示 ， 其 方法 可 参考 第 2 章 中 有 关 Proteus 的 介绍 。 
































PAassiRx FT 
PA3ISSIFSS 上 20 
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図 | 加 


PC 000004p4 CAStellarisWare_301Mboards!dkIm3s301Muart_achotuart_echoc 加 El 
RO 00000001  R7 20000100 3 = A ta EA 
RL 00000000 RS 00000000 











UARTConf igsetExpC1k(UARTO_BASE, SysCtlclockGet(), 115 
(UART_CONFIG_WLEN_8 | UART_CONFIG 
UART_CONFIG_PAR_NONE)); 


R2 00000000 R9 00000000 
R3 00000060 R10 00000000 
R4 4000C000  R11 00000000 
R5 00000000 R12 00000000 
R6 00000000 LR 00000AC3 

00000000 


MSP 200000F8 PSP / Enable て he UART 1nterrupt. | 
































APSR CNQVZ EPSR 01000000 IntEnable(INT_UARTO); | 
10001 iciit 000.00000 UARTINtENable(UARTO BA ART_INT_RX | UART_INT_RT); 
| 
| 
— - Prompt for te ed. | 
1 出 pe 
0 UARTSend((unsigned char *)"enter text:", 12); | 
内 ー // Loop forever echo1ng data て through the UART. | 
| 
ei 一 写 


图 3-11 uart_echo 工程 在 Proteus 中 的 测试 结果 
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。。 第 人 总 。。 
模 数 转换 器 (ADC) 





模 数 转换 器 (Analog - io - Digital Converter，ADC) 为 将 连续 模拟 电压 转换 为 离散 数字 
量 的 外 设 。 它 包含 两 个 完全 相同 的 转换 器 模块 ， 共 用 12 个 输入 通道 。 

TM4C123GH6PM ADC 模块 具有 12 位 的 转换 精度 ， 支 持 12 个 输入 通道 和 一 个 内 部 温度 
传感器 。 每 个 ADC 模块 都 包含 4 个 可 编程 的 序列 发 生 器 ， 无 须 控 制 器 干预 就 可 对 多 个 模拟 
输入 源 进行 采样 。 每 个 采样 序列 发 生 器 均 可 提供 灵活 的 编程 完全 可 配置 的 输入 源 、 触 发 事 
件 、 中 断 的 产生 与 序列 发 生 器 的 优先 级 等 。 此 外 ， 转 换 后 的 值 还 可 选择 转移 到 一 个 数字 比较 
器 模块 中 ， 且 每 个 ADC 模块 均 可 提供 8 个 数字 比较 器 。 每 路 数字 比较 器 可 将 ADC 转换 后 
的 值 与 2 个 由 用 户 定义 的 值 进行 评估 ， 以 确定 信号 的 工作 范围 。ADC0 和 ADC1 既 可 采用 独 
立 的 触发 源 ， 也 可 采用 相同 的 触发 源 ， 以 及 既 可 采用 相同 输入 信号 ， 也 可 采用 不 同 的 模拟 输 
和 人 。 移 相 器 可 由 指定 的 相位 角 来 延迟 启动 采样 ， 则 当 同 时 使 用 ADC 模块 时 ， 它 的 采样 点 既 
可 配置 成 同 相 方式 ， 也 可 配置 为 互 成 一 定 的 相 角 。 

ADC API 提供 了 一 组 用 于 操作 ADC 的 函数 。 其 固件 库 函 数 可 用 来 配置 采样 序列 、 读 取 
采样 值 、 配 置 采 样 序列 的 中 断 处 理 程序 与 处 理 中 断 屏 项 /清除 等 。 该 驱动 包含 在 driverlib/ 
adc.c 中 , driverlib/adc. h 含有 应 用 程序 使 用 的 API 的 定义 。 


本 章 主 要 内 容 : 


> ADC 模块 简介 
> ADC 固件 库 函 数 ( 见 附录 了 B) 
> 例 程 


























ADC 特点 





Tiva TM4C123CH6PM 微 控 制 器 提供 了 两 个 ADC 模块 (如 图 4-1 所 示 ) ， 每 个 都 具有 以 
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下 功能 : 

1) 12 个 共用 模拟 输入 通道 。 

2) 12 位 高 精度 ADC。 

3) 可 配置 为 单 端 和 差分 输入 。 

4) 片上 内 部 温度 传感器 。 

$) 最 大 采样 率 为 一 百 万 次 采样 / 秒 。 

6) 可 选 的 可 编程 采样 周期 使 相 移 从 22. 5° 到 337. 5°。 

7) 4 个 可 编程 的 采样 转换 序列 发 生 器 ， 其 长 度 为 1 到 8 个 单元 ， 且 带 有 相应 的 转换 结 
果 FIFO。 

8) 灵活 的 触发 控制 

① 控制 器 (软件) 。 

② 定时 器 。 

③ 模拟 比较 器 。 

④ CPIO。 

9) 硬件 可 对 多 达 64 个 采样 平均 。 

10) 数字 比较 器 模块 提供 8 个 数字 比较 器 。 

11) 使 用 VDDA 和 CNDA 作为 转换 器 的 基准 电压 。 

12) 模拟 电源 与 数字 电源 ， 以 及 模拟 地 和 数字 地 是 彼此 分 开 的 。 

13) 用 微型 直接 内 存 访问 控制 器 (uDMA) 进行 高 速 传输 : 

① 每 个 采样 序列 的 专用 通道 。 

② ADC 模块 的 DMA 使 用 突 发 请 求 。 


ADC 模块 框图 


TM4C123GH6PM 微 控 制 器 包含 两 个 相同 的 模拟 /数字 转换 器 (ADC) 模块 。 这 两 个 模块 
(ADCO 和 ADC1) 共享 相同 的 12 个 模拟 输入 通道 。 每 个 ADC 模块 独立 运作 ， 因 此 可 以 执行 
不 同 的 采样 序列 ， 在 任何 时 间 均 可 对 任 一 模拟 输入 通道 进行 采样 ， 并 产生 不 同 的 中 断 和 触发 
事件 。 如 图 4-1 所 示 。 


中 断 /触发 天 


图 4-1 两 个 ADC 模块 的 实现 框图 


ADC 的 模块 框图 如 图 4-2 所 示 。 


























中 断 /触发 一 
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信号 描述 
ADC 模块 的 外 部 信号 及 其 功能 描述 见 表 4-1。 
表 4-1 ADC 信号 (64LQFP) 

























































































引 脚 名 称 引 脚 号 引 脚 复 用 / 引 脚 赋值 引 脚 类 型 缓冲 区 类 型 描述 
AINO 6 PE3 1 模拟 模 数 转换 器 输入 0 
AIN1 7 PE2 1 模拟 模 数 转换 器 输入 1 
AIN2 8 PEl I 模拟 模 数 转换 器 输入 2 
AIN3 9 PEO 1 模拟 模 数 转换 融 输 入 3 
AIN4 64 PD3 I 模拟 模 数 转换 器 输入 4 
AIN5 63 PD2 1 模拟 模 数 转换 器 输入 5 
AIN6 62 PD1 I 模拟 模 数 转换 器 输入 6 
AIN7 61 PDO I 模拟 模 数 转换 器 输入 7 
AIN8 60 PF5 I 模拟 模 数 转换 器 输入 8 
AIN9 59 PF4 I 模拟 模 数 转换 器 输入 9 
AIN10 58 PB4 1 模拟 模 数 转换 器 输入 10 
AIN11 57 PB5 I 模拟 模 数 转换 器 输入 11 
功能 简介 


1. 采样 序列 发 生 器 
采样 控制 和 数据 采集 都 是 由 采样 序列 发 生 器 (Sample Sequencer) 处 理 的 。 所 有 序列 发 
生 需 都 是 相同 的 ， 唯 一 的 差别 在 于 其 能 够 捕获 的 样本 数量 与 FIFO 的 深度 (見 表 4-2)。 捕 
捉 到 的 每 个 采样 都 要 存 入 FIFO 中 。 在 此 实现 中 ， 每 个 FIFO 入 口 均 为 一 个 32 位 的 字 , 其 低 
12 位 包含 的 是 转换 结 
表 4-2 序列 发 生 器 的 采样 数 和 FIFO 深度 

















序列 发 生 器 采样 数量 FIFO 深度 
SS3 1 1 
SS2 4 4 
SS1 4 4 
SS0 8 8 








对 于 指定 的 采样 序列 ， 若 以 n 代表 其 序号 ， 则 采样 序列 n 中 的 每 个 采样 动作 分 别 以 
ADC 采样 序列 输入 多 路 复 用 需 选 择 寄存 需 (ADCSSMUXn) 与 ADC 采样 序列 控制 寄存 顺 
(ADCSSCTLn) 中 的 1 个 半 字 节 来 定义 。 该 ADCSSMUXn 用 于 选择 输入 引 脚 ， 而 ADCSSCTLn 
包含 采样 控制 位 ， 这 些 控制 位 分 别 与 参数 〈( 例 如， 温度 传感器 的 选择 、 中 断 使 能 、 序 列 末 
端 和 差分 输入 模式 等 ) 对 应 。 采 样 序列 发 生 器 可 以 通过 置 位 ADC 来 激活 采样 序列 发 生 器 寄 
存 器 (ADCACTSS) 中 的 相应 ASENn 位 进行 使 能 ， 且 可 在 使 能 之 前 进行 配置 。 软 件 可 通过 
置 位 ADC 处 理 器 采样 序列 使 能 寄存 器 (ADCPSSI) 中 的 SSn 位 来 使 能 采样 。 此 外 ， 通 过 配 
60 











置 ADCPSSI 寄存 器 的 GSYNC 和 SYNCWAIT 位 可 同时 使 能 多 个 ADC 模块 的 多 个 采样 序列 。 

2. 模块 控制 

在 控制 逻辑 单元 中 ， 除 采样 序列 发 生 器 之 外 的 其 余部 分 将 负责 执行 以 下 任务 : 

① 产生 中 断 。 

② DMA 操作 。 

@) 采样 序列 按 优 先 级 执行 。 

④ 配置 触发 事件 。 

⑤ 配置 比较 器 。 

⑥ 采样 相位 控制 。 

⑦ 模块 时 钟 。 

大 多数 的 ADC 控制 逻辑 都 是 在 16 MHz 的 ADC 时 钟 速率 下 运行 的 。 当 系统 XTAL 选 定 
PLL 时 ， 硬 件 将 自动 配置 内 部 的 ADC 分 频 系 数 ， 使 之 在 16 MHz 频率 进行 操作 。 

(1) 中 断 

采样 序列 发 生 器 和 数字 比较 器 的 寄存 器 配置 可 决定 哪些 事件 会 产生 原始 中 断 ， 但 对 于 中 
断 是 否 真 的 发 送 给 中 断 控制 器 并 没有 控制 权 。ADC 模块 是 否 产 生 中 断 信 号 是 由 ADC 中 断 屏 
蔽 寄 存 器 (ADCIM) 中 的 MASK 位 决定 的 。 中 断 状态 可 从 两 个 位 置 查询 : 其 一 ，ADC 原始 
中 断 状 态 寄存 器 (ADCRIS) 显示 各 个 中 断 信号 的 原始 状态 ; 其 二 ，ADC 中 断 与 清除 寄存 器 
(ADCISC) 显示 经 ADCIM 寄存 器 使 能 后 的 实际 中 断 状态 。 通 过 向 ADCISC 对 应 的 IN 位 写 1 
来 清除 中 断 。 注 意 ， 数 字 比 较 器 中 断 不 是 通过 本 寄存 器 清除 的 ， 而 是 通过 向 ADC 数字 比较 
器 中 断 状 态 与 清除 寄存 器 (ADCDCISC ) 的 对 应 位 写 1 来 清除 的 。 

(2) DMA 操作 

如果 使用 DMA ， 则 每 个 采样 序列 发 生 器 都 能 独立 工作 ， 无 须 微 控 制 器 干预 或 重 置 就 可 
传输 数据 来 提高 效率 。 每 个 采样 序列 发 生 器 均 可 向 pDMA 控制 器 中 的 相关 专用 通道 发 送 请 
求 , 但 ADC 不 支持 单 次 传输 请 求 。 当 采样 序列 的 中 断 标志 位 置 位 时 (ADCSSCTLn 寄存 器 的 
IE 位 置 位 ) 将 发 出 突 发 传输 请 求 。 而 pDMA 传输 的 仲裁 大 小 必须 是 2 的 整数 需 ， 且 
ADDSSCTLn 寄存 器 的 相关 IE 位 必须 置 位 。 

(3) 优先 级 

当 同 时 出 现 多 个 采样 事件 (触发 条 件 ) 时 ， 可 按 ADC 采样 序列 器 优先 级 寄存 器 (ADC- 
SSPRI) 所 定义 的 优先 级 顺序 依次 执行 。 优 先 级 的 有 效 值 为 0~3， 其 中 0 代表 最 高 优先 级 、 
3 代表 最 低 优先 级 。 如 果 多 个 激活 的 采样 序列 具有 相同 的 优先 级 ， 将 导致 转换 结果 数据 不 连 
续 ， 因 此 软件 必须 确保 当前 激活 的 所 有 采样 序列 各 自 具 有 唯一 的 优先 级 。 

(4) 采样 事件 

每 个 采样 序列 发 生 器 的 采样 触发 条 件 均 可 通过 ADC 事件 复 用 选择 寄存 器 ( ADCEMUX ) 
来 定义 。 触 发 事件 源 包括 微 控 制 器 触发 (默认 值 )、 模 拟 比 较 器 触发 、 由 CPIO ADC 控制 寄 
存 各 (GPIOADCCTL) 指定 的 CPIO 外 部 信号 触发 、 通 用 定时 器 触发 和 连续 采样 触发 。 可 通 
过 将 ADC 处 理 器 采样 序列 使 能 寄存 器 (ADCPSSI) 中 的 SSx 位 置 位 来 使 能 采样 序列 。 在 配 
置 连续 采样 触发 条 件 时 务必 慎重 ， 若 某 个 采样 序列 的 优先 级 过 高 ， 可 能 导致 其 他 低 优先 级 采 
样 序 列 始终 无 法 运行 。 一 般 将 使 用 连续 采样 模式 的 采样 序列 器 设置 为 最 低 优 先 级 ， 当 输入 口 
上 的 电压 达到 某 一 定 值 时 ， 连 续 采 样 可 与 数字 比较 器 配合 使 用 来 产生 中 断 。 
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(5) 采样 相位 控制 

ADCO 和 ADC1 可 单独 采用 不 同 的 触发 源 ， 也 可 采用 相同 的 触发 源 ; 既 可 单独 采用 不 同 
的 模拟 输入 端 ， 也 可 采用 同一 模拟 输入 端 。 若 两 个 转换 器 以 相同 的 采样 率 工 作 ， 其 采样 点 既 
可 以 配置 为 同 相 ， 也 可 以 配置 为 相互 错开 一 定 的 相 角 。 采 样 点 延 后 的 相位 在 0" 到 337.5° 之 
间 以 22. 5° 递 增 ,， 并 通过 ADC 采样 相位 控制 寄存 器 (ADCSPC) 进行 设置 ， 如 图 4-3 所 示 。 


OH 12 13 14 115 16 117 |18 119 











图 4-3 采样 相位 


(6) 模块 时 钟 

该 模块 的 16 MHz 时 钟 可 由 PLL 分 频 输 出 、PIOSC 或 连接 到 MOSC 的 外 部 时 钟 源 获 得 。 
当 PLL 处 于 工作 状态 时 ，ADC 时 钟 默 认 值 为 PLL : 25。 而 PIOSC 可 用 于 使 用 ADC 时钟 配置 
寄存 器 (ADCCC) 的 模块 时 钟 。 若 将 PIOSC 作为 ADC 的 时 钟 ， 首 先 给 PLL 上 电 ， 然 后 在 
ADCCC 寄存 器 中 的 CS 位 字段 使 能 PIOSC， 最 后 禁止 PLL。 当 PLL 被 旁 路 时 ， 连 接 到 MOSC 
模块 的 时 钟 源 必 须 为 16 MHz， 和 否则 只 能 将 PIOSC 作为 时 钟 源 。 要 使 用 MOSC 时 钟 的 ADC, 
首先 给 PLL 上 电 ， 然 后 使 能 ADC 模块 时 钟 ， 再 后 禁用 PLL 并 切换 到 MOSC 系统 时 钟 。 如 果 
PIOSC 是 ADC 模块 的 时 钟 源 ， 则 ADC 模块 可 以 继续 在 深度 睡眠 模式 下 运行 。 

系统 时 钟 必须 三 ADC 模块 的 时 钟 。 使 所 有 ADC 模块 共享 相同 的 时 钟 源 有 助 于 在 多 个 转 
换 设 备 间 同步 数据 采样 。 

3. 硬件 采样 平均 电路 

使 能 硬件 采样 平均 电路 虽 可 获得 更 高 的 精度 ， 但 其 代价 是 吞吐 率 会 成 比例 地 降低 。 硬 件 
采样 平均 电路 最 高 可 将 64 次 采样 结果 累加 并 计算 出 平均 值 ， 以 平均 值 作为 单 次 采样 的 数据 
写 人 序列 发 生 器 FIFO 的 1 个 单元 中 。 由 于 是 算术 平均 值 ， 则 吞吐 率 与 求 平均 值 的 采样 数目 
成 反比 。 例 如 ， 若 取 16 次 采样 进行 平均 值 计算 ， 那么 吞 叶 率 将 降 为 1/16。 
默认 硬件 采样 平均 电路 是 关闭 的 ， 转 换 器 捕 提 的 所 有 
数据 将 直接 传送 到 序列 发 生 器 的 FIFO 中 。 进 行 平 均 计算 
的 硬件 由 ADC 采样 平均 控制 寄存 器 (ADCSAC) 进行 控 
制 。 每 个 ADC 模块 只 有 一 个 平均 电路 ， 不 论 单 端 输入 还 
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是 差分 输入 都 将 执行 相同 的 求 平 均值 操作 。 人 
如 图 4-4 所 示 给 出 了 一 个 范例 。 其 中 ，ADCSAC 寄 1 1 

存 器 设置 为 0x2 以 进行 4x 硬 件 过 采样 ; TE1 被 置 位 以 IM | 

提供 采样 队列 ， 当 第 2 个 平均 值 储存 到 FIFO 后 ， 会 产 

生 中 断 。 图 4-4 硬件 采样 平均 处 理 
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4. 模 数 转 换 器 

模 数 转换 需 (ADC) 模块 采用 逐次 逼近 寄存 需 ( Successive Approximation Register 
(SAR) ) 架构 提供 一 个 12 位 、 低 功 耗 、 高 精度 的 转换 值 。 逐 次 通 近 使 用 一 个 开关 电容 阵 
列 ， 以 实现 采样 和 保持 信号 的 双重 功能 ， 并 提供 12 位 的 DAC 操作 。 该 ADC 需要 16 MHz 的 


时 钟 ， 这 个 时 钟 可 以 是 PLL 输出 的 分 频 值 、PIOSC 或 连接 到 MOSC 的 一 个 16 MHz 时钟 源 。 
ADC 输入 等 效 电 路 框图 如 图 4-5 所 示 。 
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图 4-5 ADC 输入 等 效 电 路 框 区 

ADC 模块 同时 从 3.3V 模拟 电源 和 1.2V 数字 电源 取 电 。 在 不 要 求 ADC 转换 精度 时 ， 

可 以 将 ADC 时 钟 配置 为 低 功 耗 。 从 自 定义 引 脚 上 输入 的 模拟 信号 通过 特殊 的 平衡 输入 通道 
连接 到 ADC， 尽 量 降低 输入 信和 号 的 失真 。 


(1) 基准 电压 
ADC 使用 内 部 信号 VREFP 和 VREFN 作为 基准 电压 以 产生 一 个 选 定 模拟 输入 的 转换 值 。 


VREFP、VREFN 分 别 连 接 到 VDDA 和 GNDA， 如 图 4-6 所 示 。 












































图 4-6 ADC 基准 电压 


转换 值 的 范围 为 0x000 ~ OxFFF。 在 单 端 输 入 模式 ，0x000 值 对 应 的 电 平 为 VREEN, 而 
OxFFF 值 对 应 的 电 平 为 VREFP。 此 配置 的 结果 可 用 下 列 公式 计算 ; 
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mV per ADC code = ( VREFP - VREFN )/4096 
尽管 模拟 输入 引 脚 可 以 处 理 超出 此 范围 的 电压 ， 但 在 欠 电 压 及 过 电压 时 A - D 转换 结 
将 会 饱和 。 图 4-7 所 示 为 ADC 与 输入 模拟 电压 的 函数 关系 。 
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图 4-7 ADC 转换 结果 





(2) 差分 采样 

除了 传统 的 单 端 采样 ，ADC 模块 还 支持 对 两 个 模拟 输入 通道 进行 差分 采样 。 差 分 采样 
可 通过 设 定 ADCSSCTLO 寄存 器 中 的 Dn 位 来 使 能 。 若 采样 序列 中 某 个 采样 动作 配置 为 差分 
采样 ， 必 须 通 过 ADCSSMUXn 寄存 器 来 选择 输入 的 差分 信号 对 。 差 分 信号 对 0 对 模拟 输入 端 


ラー ーー 


0 和 1 进行 采样 ， 差 分 信号 对 1 对 模拟 输入 端 2 和 3 进行 采样 ， 依 此 类 推 ， 见 表 4-3。 


























表 4-3 差分 采样 对 
差分 信号 对 模拟 输入 端 差分 信号 对 模拟 输入 端 
0 0 和 1 4 8 和 9 
1 2 和 3 5 10 和 11 
2 4 和 5 6 12 和 13 
3 6 和 7 7 14 和 15 











注意 : ADC 不 支持 差分 信号 对 的 随机 组 合 ， 如 模拟 输入 端 0 和 模拟 输入 端 3 无 法 作为 

一 对 差分 信号 输入 。 
差分 模式 下 采样 电压 是 奇数 通道 与 偶数 通道 电压 的 差 值 ; 
差分 电压 为 AV = VIN_EVEN (偶数 通道 ) - VIN_ODD( 奇 数 通道 ) 。 
> 如果 AV =0， 则 转换 结果 =0x800。 
> 如果 AV >0， 则 转换 结果 >0x800 ( 取 值 范围 为 0x800 ~OxFFF) 。 
> 如果 AV <0， 则 转换 结果 <0x800 ( 取 值 范围 为 0 ~0x800) 。 
对 于 转换 准确 度 为 AVe | -AVADCVer,AVADCVnar| 
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ADCV -ADCV 
4096 





分 辨 率 为 mv/ADCCode =2 x 


差分 采样 如 图 4-8 所 示 。 
5. 内 部 温度 传感器 


温度 传感器 的 主要 作用 是 当 芯 片 温度 过 高 或 过 低 时 向 系统 给 予 提示 ， 保 障 芯 片 稳定 工 
作 。 温 度 传 感 占 没有 单独 的 使 能 /禁止 操作 ， 因 为 它 关 系 到 带 际 参考 电压 的 产生 ， 而 带 际 基 











准 电压 不 仅 提 供给 ADC 模块 、 还 需要 提供 给 片 内 其 他 所 有 模拟 模块 ， 因 此 必须 始终 使 能 。 
内 部 温度 传感器 提供 模拟 温度 读数 以 及 基准 电压 Vi,,。( 如 图 4-9 所 示 )， 其 大 小 可 以 通过 





下 列 公 式 计算 : 
TC6JtSS 
Va lp 2. 7V 75 
75 x (VREFP - VRERN) xADCeonr 
4096 
其 中 ， ADC 为 ADC 读数 、 最 大 ADC 电压 范围 为 VREFP - VREFN。 





T(C') =147.5 - 











0.3 























~ 7 
1 ヽ 、 Ox000 | レ < AVIN 


| 
+ 
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1 
ヽ 
AVADCVrer AVADCVrer 


pe es か 3 
N ~ 0 
饱和 区 Ox0 0x400 Ox800 OxC00 


OxFFF 


图 4-8 差分 采样 图 4-9 内 部 温度 传感器 


6. 数字 比较 器 





ADC 通常 用 于 对 外 部 信号 采样 并 监控 其 数值 的 变动 ， 确 保 其 保持 在 给 定 的 范围 内 。 





为 了 实现 此 监控 过 程 的 自动 化 、 减 少 所 需 的 处 理 需 开销 , 每 个 ADC 模块 提供 


8 个 数字 比 


较 器 。ADC 转换 结果 可 直接 发 送 给 数字 比较 器 ， 与 用 户 编 程 的 门限 进行 比较 。 门 限 通过 
ADC 数字 比较 器 范围 寄存 器 (ADCDCCMPn) 配置 。 假 如 被 监控 的 信号 超出 了 容许 的 范 











围 ， 则 产生 一 个 处 理 融 中 断 及 /或 向 PWM 模块 发 送 一 个 触发 事件 。 用户 可 将 数字 比较 顺 的 


4 种 工作 模式 ( 单 次 触发 、 持 续 触 发 、 述 滞 单 次 触发 、 述 滞 持 续 触 发 ) 应 用 于 3 个 相互 独 
立 的 区 域 (低频 段 、 中 频段 、 高 频段 ) 中 。Tiva C ADC 详细 的 技术 文档 请 参考 TI 的 相关 


文献 。 
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アン 
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4.2 ADC 固件 库 函 数 


ADC 采 样 





ADC Sequence Configure() 
ADC Sequence StepConfigure() 
ADC SequenceEnable() 

ADC SequenceDisable() 








ADC 处 理 器 触发 





ADCProcessorTrigser() 








Inpu 
Analog Input Channel 


图 4-10 ADC 回 





① 处 理 采 样 序列 。 
② 处 理 触发 。 
③ 中 断 处 理 。 





ADClntRegister(O) 
ADCIntUnregister() 
ADCIntDisable() 
ADCIntEnable() 
ADCIntStatus() 
ADCIntClear() 


ADC 过 采样 配置 及 控制 


ADCHardwareOversampleConfigure() 
ADCSoftwareOversampleConfigure() 
ADCSoftwareOversampleStepConfigure() 
ADCSoftwareOversampleDataGet() 














ADC 采 样 序列 控制 


ADC SequenceDataGet() 


ADC SequenceOverflow() 

ADC SequenceOverflow Clear() 
ADC SequenceUnderflow() 
ADC SequenceUnderflowClear() 


Output 

















件 库 主要 函数 及 简要 使 用 流 











详细 的 ADC 固件 库 函 数 功 能 介绍 请 参考 书后 附录 B。 


4.3 例 程 





本 小 节 将 以 TI 提供 的 内 部 温度 采集 与 单 端 - 单 输入 两 个 例 程 为 例 来 介绍 ADC 固件 库 的 
使 用 编程 与 测试 方法 。 


1. 内 部 温度 传感器 例 程 


1) temperature_sensor c 程序 介绍 。 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 


//! 文件 名 : temperature_sensor. c 











//! 来 源 :TI 例 程 
//! 功能 描述 : 
ZA 











//! 注 : 内 部 温 





这 个 例子 介绍 了 如 何 通过 设置 ADCO 来 读 取 内 部 温度 传感器 的 值 
度 传感器 未 经 校准 ,其 结果 存在 误差 

















DH 








品 





本 例 程 将 使 
- ADCO 外 设 





//! 的 外 设 和 IO 信 


//1 





J 下 




















j 户 需 根据 自 











己 的 开发 板 稍 作 修改 : 


プッ 











//! 用 于 转换 结果 显示 的 UART 端口 : 

//! -UARTO 外 设 

//! -GPIOA 外 设 (UARTO 引 脚 ) 

//! -UARTORX - PAO 

//! -UARTOTX - PA1 

//! 本 例 程 为 2. 0.1. 11577 版 固件 开发 包 中 的 一 个 示例 




















Sh 
























































/ * 
nN Anon ew a worn m 
BSERRSEERSSAASSSS 
つの の 
和 2 二 
BB 48[ | |] EB3/ エ 2C0SDA 
VDDA B2/I2C0OSCL 
Gh Ie 一 ーー コテ VbAT 
硬件 连 线 图 36 | | |XOsCI 
35 GNDX 
に 
34 XOSCO 
TM4C123GH6PM 33 js 
ト - oo 
No 
[了 
LL 
8 吕 
西 
/ * 





// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポ 


#include < stdbool. h > 
#include < stdint. h > 


#include "inc/hw_memmap. h" 
#include " driverlib/adc. h" 
#include " driverlib/gpio. h" 


#include " driverlib/pin_map. h" 
#include " driverlib/ sysctl. hy" 
#include " driverlib/uart. h" 
#include "utils/uartstdio. h" 


ノノ / 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 六 
// 设 置 UARTO 用 于 显示 例 程 运行 信息 的 控制 台 函 数 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ネネ ポポ ネ ポ 























void 











InitConsole( void ) 


| 
// 











// 使 能 
// 











于 UARTO 功能 的 CPIO 引 脚 


SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA); 


// 








// 将 复 
// 











j 引 脚 A0 和 Al 配置 成 UARTO 功能 


GPIOPinConfigure( GPIO_PAO_UORX) ; 
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GPIOPinConfigure( GPIO_PA1_UOTX) ; 

// 

// 使 能 UARTO 以 便 配置 时 钟 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 

// 

// 使 用 内 部 16 MHz 振荡 器 作为 UART 的 时 钟 源 

// 

UARTClockSourceSet( UARTO_BASE,UART_ CLOCK_PIOSC) ; 

// 

// 选 择 这 些 复 用 引 脚 为 UART 功能 

// 

GPIOPinTypeUART( GPIO_PORTA_BASE, GPIO_PIN_0 | GPIO_PIN_1 ) ; 
// 

// 初 始 化 UART 搾 入 
// 
UARTStdioConfig(0,115200 ,16000000) ; 
































ーー 


台 IO 


| 

KR ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネギ 

// 配 置 ADCO 的 温度 传感器 的 输入 为 单 采 样 。 一 旦 温度 值 采 样 完成 ,中 断 标志 将 被 置 位 ,并 读 取 采 
样 数据 ,然后 通过 UARTO 将 其 显示 在 控制 台 上 


// まま ポ ネ ポポ ポポ ポポ ポポ ネ ※ 六 ※ 玉 ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 六 玉 玉 *※ 












































1nt 
main( void ) 
| 

// 

// 这 个 阵列 用 于 保存 从 ADC FIFO 中 读 取 的 数据 。 它 必须 与 使 用 中 的 序列 发 生 器 中 的 FIFO 
相同 

// 本 例 中 使 用 序列 发 生 器 3 ,其 FIFO 深度 为 1。 如 果 另 一 序列 发 生 器 使 用 较 深 的 FIFO , 则 数 
组 的 大 小 必须 改变 

// 

uint32_t pui32ADCOValue[ 1 ] ; 

// 

// 这 些 变量 用 于 保存 转换 为 摄氏 和 华氏 的 温度 

// 

uint32_t ui32TempValueC ; 

uint32_t un32TempValueF: 

// 

// 使 用 PLL ,设置 时 钟 运行 在 20 MHz(200 MHz/10 ) 。 当 使用 ADC 时 , 则 必须 使 用 PLL 或 提供 
一 个 16 MHz 的 时 钟 源 

// 

SysCtlClockSet( SYSCTL_SYSDIV_10 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN | 

SYSCTL_XTAL_16MHZ) ; 


































































































// 
// 调 用 控制 台 函 数 用 于 显示 消息 
// 


InitConsole( ) ; 


// 

// 在 控制 台 上 显示 以 下 设置 信息 
ノ // 

UARTprintf( " ADC - > \n" ) ; 
UARTprintf(" Type: Internal Temperature Sensor\n" ) ; 

UARTprintf(" Samples: One\n" ) ; 

UARTprintf(" Update Rate: 250ms\n" ) ; 

UARTprintf(" Input Pin: Internal temperature sensor\n\n" ) ; 

// 

// 使 能 待 使 用 的 ADCO 外 设 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_ADCO) ; 

// 

// 使 能 采样 序列 发 生 器 3 ,采用 处 理 器 信号 触发 。 当 处 理 器 发 出 一 个 启动 转换 信号 时 ,序列 3 





























将 进行 单 采样 








// 毎 介 ADC 模块 有 4 个 可 编程 序列 发 生 器 , 即 序列 发 生 器 0 ~3。 本 例 程 使 用 了 序列 发 生 器 3 
// 

ADCSequenceConfigure( ADCO_BASE,3 ,ADC_TRICCER_PROCESSOR ,0 ) ; 

// 

// 配 置 序列 3 的 步 进 0( step 0) 。 当 采样 进行 时 ,采样 温度 传感器 (ADC_CTL_TS ) 和 配置 中 断 
























































标志 (ADC_CTL 正 ) 将 被 设置 。 告 诉 ADC 逻辑 ,这 是 序列 发 生 需 3 最 后 一 次 转换 (ADC_CTL_ 
END ) 

序列 3 仅 具 有 一 个 可 编程 的 step ,而 序列 1 和 2 具有 4 个 步 进 (step ) ,以 及 序列 0 具有 8 个 
可 编程 的 步 长 





// 因 为 仅 采 用 序列 3 进行 单 次 转换 ,只 需 配置 step 0 即 可 

ZN 

ADCSequenceStepConfigure( ADCO_BASE,3.0,ADC_CTL_TS | ADC_CTL_IE | 
ADC_CTL_END ) ; 

ZN 

// 使 能 采样 序列 发 生 器 3 

ADCSequenceEnable( ADCO_BASE ,3 ) ; 

// 

// 清 除 中 断 状态 标志 ,在 采样 之 前 需 确 保 中 断 标 志 已 被 清除 

// 

ADCIntClear( ADCO_BASE,3 ) ; 

// 

// 一 直 采 样 温度 传感器 的 值 ,并 在 控制 台 上 显示 出 来 

// 

while(1) 

| 























X/ 

// 触 发 ADC 

ノ // 

ADCProcessorTrigger( ADCO0_BASE,3 ) ; 
ノ // 

// 等 待 转换 完成 
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ノ / 


while(! ADCIntStatus( ADCO_BASE,3 ,false ) ) 


| 


// 
// 清 零 ADC 中 断 标志 
2 








ADCIntClear( ADCO_BASE,3 ) ; 


2 
// 读 取 ADC 的 值 
// 


ADCSequenceDataGet( ADCO_BASE,3 ,pui32ADCOValue ) ; 


// 


// 参 考 4.1.4(5) 内 部 温度 传感器 小 节 的 温度 值 转换 公式 
// 其 中 ,VREFP - VRERN =3V 


// 


ui32TempValueC = ( (1475 *4096) - (2250 * pui32ADCOValue[ 0]))/40960; 


// 
// 计 算 华氏 温度 值 
// 


ui32TempValueF = ( (ui32TempValueC x 9) +160)/5; 


// 


// 在 “串口 助手 ”"(PuTTY) 上 显示 摄氏 温度 值 


// 


UARTprintf("Temperature = %3d * C or %3d * F\r" ,ui32TempValueC ， 
ui32TempValueF ) ; 


// 





/ 延 授 250 ms( 更 新 速率 ) 


// 


SysCtlDelay( SysCtlClockGet( )/12) ; 


1 
i 


2) 创建 temperature_sensor 工程 。 其 操作 步骤 如 下 : 


@ 在 C:Nti\TivaWare_C_Series 


① 创建 temperature_sensor 工程 过 程 ， 如 图 4-11 所 示 。 


-2.0.1.11577 \examples \peripherals \adc 目录 下 ， 导 入 


temperature_sensor. c 文件 站 然后 按 书 中 代 人 码 修改 temperature_sensor. c 程 序 有 关 摄 氏 温 度 值 的 





计算 公式 。 
③ 配置 temperature_sensor 工程 








属性 ， 右 键 单 击 工程 ， 在 Properties 一 Build 一 ARM Com- 


pller っ Advanced Options 一 Predefined Symbols 菜单 下 添加 以 下 项 : 


@ ccs = "ccs" 。 


e PART_TM4C123CHOPM。 


e TARCET_IS_BLIZZARD_RB1 。 


④ 将 Properties 一 Build 一 ARM Linker 一 Basic Options 菜单 下 的 “Set C system stack size” 
菜单 栏 中 的 内 容 改 为 0x800。 本 例 程 规模 比较 小 ， 改 为 512 即 可 。 同 时 也 可 以 把 ”Heap size 
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for C/C ++…" 








< New CCS Project OF [Project| Run Scripts 
CCS Project ーー New CCS Project 


CCS Scala Projects 


Create anew CCS 3 ‘ld 


5 新建 工程 名 
Project name: (temperature_sensor 















Output type: |Executable 








I Use default location CT 























sMiuyu\workspace_v5_5Ntemperature_se 
Device 4 
Family: |ARM し 3 
Variant: <select or type filter text> (Tiva TM4C123GH6PME 
Connection: | 





Project templates and examples 











| 台 Empty Projecty 三 


| cw 上 uv Pro 





图 4-11 


创 建 temperature_sensor 工 程 过 程 


修改 为 200。 


type filter td ⑤) Creates an empty project i 
了 个 。 | initialized for the selected 1 
4 mpty Projects 对 


| 


3) 编译 temperature _ sensor 工程 ， 将 生成 的 .out 文件 下 载 到 LaunchPad (EK - 
TM4C123GXL) 板 中 ， 如 图 4-12 所 示 。 


幕 Debug 2 0 国 | 马 . 念 
4 Ra TM4C123G.ccxml [Code Composer Studio - Device Debugging] 
2 Stellaris In-Circuit Debug Interface_O/CORTEX_M4_0 (Suspended -+ 








图 4- 
4) 单 击 图 4-12 中 的 运行 按钮 嘱 , 


三 main() at temperature_sensor.c:196 0x00000152 


三 _c_int00( at boot.asm:217 0x00000962 (_c_int00 does not conta 





12 ”将 编译 生成 的 . out 文件 下載 到 EK - TM4C123CXL 板 H 

















TY 观察 到 的 测试 结果 如 图 4-13 所 示 。 


启动 代码 在 EK - TM4C123GXL 板 中 运行 











中 COM7 - PuTTY 

















7 也 


图 4-13 内 部 温度 测试 结 量 


2. 单 端 - 单 输入 信号 ADC 转换 例 程 
1) single_ended. c 介绍 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ボネ ポポ ネネ ポポ 


， 打 开 PuT- 
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//! 文件 名 :single_ended. c 

//! 来 源 :TI 例 程 (已 修订 ) 

//! 功能 描述 : 

//! 这 个 例 程 介绍 如 何 设置 ADCO 作为 一 个 单 端 输入 和 执行 在 AINO/PE3 引 脚 的 单 采 样 
//! 此 例 程 使 用 下 列 外 设 和 1/0 信号 : 

//! -ADCO 外 设 

//! - GPIOE 端口 外 设 ( AINO 引 脚 ) 

//! -AINO -PE3 

//! 下列 配置 UART 信号 仅 为 显示 该 例 程 的 控制 台 消息 : 

//! -UARTO 外 设 

//! -GPIO A 端口 (UARTO 引 脚 ) 

//! -UARTORX - PAO 

//! -UARTOTX - PA1 

2 






































UARTORXJPA0 
UARTOTX JPA1 








*/ 
レク キキ キキ キキ キキ キキ キキ キキ キキ キネ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 

#include < stdbool. h > 

#include < stdint. h > 

#include "ine/hw_memmap. h" 

#include "driverlib/adc. h" 

#include "driverlib/gpio. h" 

#include " driveriib/pin_map. h" 

#include "driverlib/sysctl. hy" 

#include " driverlib/uart. h" 

#include " utils/uartstdio. h" 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 

// 此 函数 用 于 设置 UARTO 的 控制 台 ,以 显示 该 例 程 运行 时 的 信息 


// ネネ ボネ ネネ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
































void 

InitConsole( void ) 

| 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 
GPIOPinConfigure( GPIO_PAO_UORX) ; 
GPIOPinConfigure( CPIO_PA1_UOTX ) ; 
SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 
UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 
GPIOPinTypeUART( GPIO_PORTA_BASE,GPIO_PIN_O | GPIO_PIN_1 ) ; 
UARTSidioConfig(0 ,115200 ,16000000 ) ; 





ンク キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ : 
// 将 ADCO 配置 为 单 端 输入 与 单 采样 模式 。 一 旦 采样 准备 就 绪 ,就 将 设置 一 个 中 断 标志 
// 使 用 轮 询 的 方法 读 取 采样 数据 ,然后 通过 UARTO 将 其 显示 在 控制 台 上 


// ネネ ネネ ネネ ホネ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ボネ ポ ネ ポポ 


int 












































main( void ) 


| 


4 

// 创 建 保存 从 ADC FIFO 中 读 取 数据 的 阵列 及 电压 值 

// 

uint32_t pui32ADCOValue[ 1 ] ; 

uint32_t ui32Vol_Value; 

// 

// 使 用 PLL ,设置 系统 时 钟 运行 在 20 MHz(200 MHz/10) 

2 

SysCtlClockSet( SYSCTL_SYSDIV_10 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_16MHZ ) ; 















































// 

// 调 用 控制 台 函 数 用 于 显示 消息 
// 

InitConsole( ) ; 

// 

// 在 控制 台 上 显示 以 下 设置 信息 
// 


UARTprintf( " ADC - > \n" ) ; 

UARTprintf(" Type: Single Ended\n" ) ; 

UARTprintf(" Samples: One\n" ) ; 

UARTprintf(" Update Rate: 250ms\n" ) ; 

UARTprintf(" Input Pin: AINO/PE3 \n\n" ) ; 

ノ / 

// 使 能 待 使 用 的 ADCO 外 设 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_ADCO) ; 

// 

// 因 为 ADCO 从 AINO( E3) 端 口 输入 , 则 必须 使 能 GPIOE 端口 

XL 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOE) ; 

// 

// 选 择 PE3 引 脚 作为 ADC 输入 

// 

GPIOPiInType ADC( GPIO_PORTE_BASE, GPIO_PIN_3); 

// 

// 使 能 采样 序列 发 生 器 3 采用 处 理 右 信号 触发 .采样 优先 级 0 

// 

ADCSequenceConfigure( ADCO_BASE,3 ,ADC_TRIGGER_PROCESSOR ,0 ) ; 

// 

// 配 置 序列 3 的 步 进 0(step 0) 。 使 用 采样 通道 0(ADC_CTL_CH0 ) ,并 在 采样 完成 时 配置 
// 中 断 标志 (ADC_CTL_IE)。 告 诉 ADC 逻辑 ,这 是 序列 3 的 最 后 一 次 转换 ( ADC_CTL_END) 
ADCSequenceStepConfigure( ADCO_BASE ,3,0, ADC_CTL_CHO | ADC_CTL_IE | 
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ADC_CTL_END ) ; 
// 
// 使 能 采样 序列 发 生 器 3 
// 
ADCSequenceEnable( ADCO_BASE ,3 ) ; 
// 
// 清 除 中 断 状 态 标志 
// 
ADCIntClear( ADCO_BASE,3 ) ; 
// 
// 采 样 AINO 的 值 并 在 控制 台 上 显示 出 来 
// 
while( 1) 
| 
Xf 
// 触 发 ADC 转换 
// 
ADCProcessorTrigger( ADCO_BASE ,3 ) ; 
XY 
// 等 待 转换 完成 
/ グ 
while(! ADCIntStatus( ADCO_BASE,3 ,false ) ) 
| 


1 
1 


ADCIntClear(ADCO_BASE ,3 ) ; 
ADCSequenceDataGet( ADCO_BASE,3 ,pui32ADCOValue ) ; 






































ノ // 

// 将 数字 电压 值 转换 成 电压 值 (12 位 ADC,3.3v 的 数字 量 为 2”=4096 ) 
ノ // 

um32Vol_Value = ( pn32ADCOValue[0] * 3.3)/4096 : 
// 

// 在 PuTTY 中 显示 AINO(PE3) 的 电压 值 

ノ // 

UARTprintf(" AINO = %4d(v) \r" ,ui32Vol_Value) ; 

// 

// 延 迟 250 ms (更 新 速率 ) 

// 


SysCtlDelay( SysCtlClockGet( )/12) ; 


| 


2) 在 C:\ti\TivaWare_C_Series - 2.0.1.11577 \examples \ peripherals \adc 目录 下 ， 导 入 
single_ended. c 文件 ， 然 后 按 书 中 内 容 修改 。 

3) 创建 工程 、 编 译 等 和 上 例 相 同 ， 此 处 省 略 。 

4) 测试 。 

① 读者 可 以 按 上 述 硬件 连接 图 进行 ， 通 过 调节 电位 器 来 改变 ADC 的 输入 电压 ， 从 而 得 
到 不 同 的 ADC 转换 值 。 如 果 读 者 觉得 外 接 电位 器 比较 麻烦 ， 也 可 直接 在 EK - TM4C123GXL 
板 上 寻找 几 个 已 知 的 电压 值 ， 比 如 VDDC (万 用 表 测 得 该 点 的 电压 为 3. 27V) 和 接地 信号 来 
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测试 程序 的 正确 性 。 电 压 采 集 点 如 图 4-14 所 示 。 


jo 
EF 
8 

"所 











图 4-14 VDDC 电压 的 采集 接线 图 〈 用 杜邦 线 将 电压 值 送 到 AINO ) 





@) 将 编译 生成 的 .out 文件 下 载 到 LaunchPad 板 中 ， 单 击 嘱 运行 按钮 ， 其 测试 结果 如 
图 4-15 所 示 。 


ト www.W.comvlaunchpod a | 
DEvicE Ekta mew 学 COM7 - PuTTY 
5 .，VDDc = ーー | 电压 测试 点 | ーー 











图 4-15 单 端 - 单 输入 信号 的 ADC 转换 结果 (AINO =3V or 0v) 





从 图 4-15 中 可 以 看 到 ， 万 用 表 实 测 的 VDDC =3.27V， 而 ADC 转换 得 到 数字 电压 ， 通 
过 换算 后 得 到 的 电压 值 =3 V， 存 在 误差 。 下 面 将 进一步 验证 该 误差 是 由 显示 控制 台 程序 的 
显示 格式 (%d) 所 致 ， 还 是 由 ADC 转换 的 精度 不 够 所 造成 ? 

① 在 Expressions 窗口 添加 ui32Vol_Value 变量 ， 并 按 下 数据 连续 更 新 图 标 国 ， 如 


图 4-16 所 示 。 


四 = Variables Fi Expressions| (NNRegisters ey 至 加 | 
一 村 二 E 加 % 


| 

六 

| 

| Expression Type Value Address 
| 


9 ui32Vol Value | unknown Error.… 


中 Add new expres: 球 、 






































器 


4-16 添加 ui32Vol_Value 变量 
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ADCIntClear(ADC6_BASE，3); MM 


7// ど 


// Read ADC Value . 


ADCSequenceDataGet(ADC9_BASE, 3, ie 


の 


ui32Vol Value=( pui32ADC6value[9] * 3.3)74996: 站 





4-17 设置 断 点 


③ 连续 单 击 程序 运行 按钮 忠 ， 直 到 Expressions 窗口 中 变量 ui32Vol_Value 的 值 不 再 变 
化 为 止 ， 如 图 4-18 所 示 。 


- Variables | Expressions 8 | li 
ke x 荣 国 | 喇 二 | 名 了 

Expression Type Vale Address 

unsigned int @) Ox200001F4 


Add new expres: 


4-18 ADC 的 转换 结果 





从 图 4-18 可 以 看 到 ，ADC 的 转换 结果 =3V 和 前 面 在 PuTTY 中 的 显示 结果 一 致 ， 说 明 
误差 是 由 于 TM4C123GH6PM 的 片 载 ADC 转换 器 精度 不 够 所 致 。 

在 读 取 某 点 数据 值 时 ， 也 可 以 不 用 按 下 连续 更 新 图 标 [ 国 ， 而 采用 通过 设置 断 点 属性 获 
得 。 其 步骤 如 下 : 

Qa 右键 单 击 所 设 断 点 ， 在 弹出 的 下 拉 菜 单 中 选择 Breakpoint Properties 选项 。 

② 单 击 Breakpoint Properties 子 菜 单 ， 在 弹出 的 下 拉 菜 单 中 将 Action 选项 设置 为 Update 
View， 如 图 4-19 所 示 。 











Toggle Breakpoint 
Disable Breakpoint 


Breakpoint Properties.』 | 号 Breakpoint Properties 
Breakpoint Types 准 = 
5 Properties Values 
Go to Annotation 5 
4 Hardware Configuration 


> Count 
y Show Line Numbers 站 

人 Update view) ず 
® View Expressions 3 


a 
图 4-19 设置 数据 连续 更 新 模式 


讨论 : 从 上 面 的 介绍 可 以 看 出 ， 并 非 是 显示 方式 造成 的 误差 ， 那 只 可 能 是 ADC 转换 精 
度 或 转换 程序 存在 问题 。 为 了 做 出 这 个 判断 ， 最 佳 的 办 法 是 : 观察 ADC 输出 的 数字 量 是 否 


Add Bookmark... , Type rp 并 
Add Task... 选中 Update 
as 4 Debugger Response 
Show Quick Diff candition 
0 








Preferences... 
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正确 ， 其 步骤 如 下 : 


① 将 pui32ADCOValue[0] 添 加 到 表达 式 窗 口 。 
② 添加 一 个 观察 pui32ADCOValue[0] 值 的 断 点 ， 如 图 4-20 所 示 。 


// 
// Read ADC Value. 
// 


ADCSequenceDataGet(ADC9_BASE, 3, pu132ADC9Va]ue ) : 
设置 断 点 获取 ADC 的 转换 结果 











图 4-20 ”在 图 示 位 置 设置 一 个 断 点 























③ 单 击 工 具 栏 上 的 史 图 标 让 程序 运行 到 断 点 处 并 单 步 执行 程序 ， 此 时 在 表达 式 窗 口中 
见 察 到 的 pui32ADCOValue[ 0] 值 为 4095 (3.3 V/12 位 的 ADC 输出 为 4096) ， 说 明 ADC 输出 
“Aan 那么 产生 上 述 ADC 转换 结果 误差 较 大 的 原因 是 电压 换算 语句 存在 问题 。 即 
ui32Temp_Value = ( pui32ADCOValue[0] * 3.30)/4096 ; 
修改 这 条 语句 的 步 又 如 下 : 


oy 点 类 型 的 变量 adcResult, 井 使 能 FPULazy 堆栈 ， 如 图 4-21 所 示 。 
uint32 t ui32Temp Value: 


使 RS 
// 使 メン 添加 






能 FPULazy 胁 栈 
FPULazyStackingEnable() ; 














图 4-21 添加 变量 定义 及 使 能 FPULazy 堆栈 
② 将 电压 换算 语句 修改 为 : 





ui32Temp_Value = pui32ADCOValue[ 0 ] : 
adcResult = (float) (ui32Temp_Value* 3.30/4096 ) ; 


③ 添加 一 个 观察 ADC 转换 结果 的 断 点 ， 如 图 4-22 所 示 。 


u132Temp Value=( pu132ADC9Value[9] * 3.39)/4996 
ui32Temp_Value= pui32ADC9Value[9] : 
| adcResu]t=(f1oat ) (u132Temp Value* 3.39/4996 ) : 
设置 观看 ADC 结 果 的 断 点 





2 








图 4-22 在 图 示 位 置 设置 观察 ADC 转换 结果 的 断 点 


④ 将 ADC 转换 结果 adcResult 添加 到 表达 式 窗口 中 ， 如 图 4-23 所 示 。 
C= Variables(@ Expressions 3 中 


Registers 
Expression A Value Address 


WW- pui32ADCOValue[ON unsignedint 4095 0x200001F0 
= adcResult 


NaN Ox200001F8 







































中 497 new expression 








器 











4-23 将 变量 adcResult 添加 到 表 : 


实 
或 
ロ 
十 
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⑤ 单 击 工具 栏 上 的 中 图 标 让 程序 运行 到 断 点 处 并 单 步 执行 程序 ， 此 时 在 表达 式 窗口 观 
察 到 的 ADC 转换 结果 如 图 4-24 所 示 。 


09= Vari able Expressions 3 i Registers 


Expression T Value Address 


or pui32ADCOValue[O] unsignedint 409 0x200001F0 
9 adcResult S グ 3.299194 JO0x200001F8 


ADC 转 换 结果 的 精度 足够 高 

















图 4-24 最 后 的 ADC 值 已 过 电压 换算 后 的 结果 


说 明 : 电压 换算 语句 经 过 上 述 修改 后 得 出 的 3. 3V 模拟 输入 的 ADC 转换 结果 正确 。 
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Q 9 第 う 章 ③④ の 
通用 输入 /输出 (GPIO) 


通用 输入 /输入 端口 (Ceneral - Purpose Input/Output, GPIO) 为 微 控制 避 与 被 控 对 象 间 
的 信息 交流 通道 端口 。TM4F123G6HPM 世 片 包含 6 个 物理 CPIO 模块 ， 每 个 模块 都 对 应 一 
个 单独 的 CPIO 端口 〈 即 端口 A -F) 。GPIO 模块 支持 高 达 43 个 可 编程 的 输入 /输出 引 脚 ， 
并 且 这 些 引 脚 可 配置 成 多 种 工作 模式 ， 如 高 阻 输入 、 推 挽 输 出 与 开 漏 输出 等 。 

GPIO API 提供 了 一 组 实现 GPIO 功能 的 函数 ， 包 含 在 driverlib/gpio. c 中， 而 driverlib/ 
gpio. h 头 文件 包含 了 API 的 定义 。 


本 章 的 主要 内 容 : 


> GPIO 模块 
> CPIO 固件 库 函 数 ( 见 附录 C) 
> 例 程 

















GPIO 特点 


GPIO 模块 具有 以 下 特点 : 

1) 高 达 43 个 GPIO 端口 ， 具 体 取决 于 外 设 的 配置 。 

2) 高 度 灵活 的 复 用 引 脚 ， 可 作为 CPIO 或 多 种 外 设 功能 。 
3) 5V 容错 输入 配置 。 

4) 通过 高 级 外 设 总 线 (APB) 访问 端口 A ~G。 

5) 具有 在 1 个 或 2 个 时 钟 周期 内 快速 切换 AHB 端口 的 能 
6) 可 编程 控制 的 CPIO 中 断 : 

① 屏蔽 中 断 产 生 。 

② 边沿 触发 (上升 沿 、 下 降 沿 或 双 沿 ) 。 

③ 电 平 触发 (高 电 平 或 低 电 平 )。 

7) 在 读 和 写 操作 中 通过 地 址 线 进行 位 屏蔽 。 

8) 可 用 于 使 能 ADC 采样 序列 或 wDMA 传输 。 

9) 在 休眠 模式 下 可 保留 引 脚 的 状态 。 

10) 可 配置 数字 输入 引 脚 为 施 密 特 触发 。 
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11) 可 编程 控制 GPIO 引 脚 配置 ; 

① 弱 上 拉 或 下 拉 电 阻 。 

② 具有 2 mA 、4mA、8mA 的 数字 通信 驱动 电流 ; 对 于 需要 大 电流 的 应 用 ， 
脚 可 承载 18 mA 电流 。 

③ 具有 8 mA 驱动 的 斜率 控制 。 

④ 开 漏 使 能 。 

⑤ 数字 输入 使 能 。 


GPIO 模块 框图 
GPIO 的 模拟 /数字 口 模块 框图 如 图 5-1 所 示 。 


多 达 4 个 引 


提交 模式 
補間 控制 控制 


GPIOAFSEL 
GPIOADCCTL 
GPIODMACTL 


GPIOLOCK 


| GPIOPCTL | | GPIOCR | 















外 设 0 ーー 






























外 设 1 = 


输出 使 能 








外 设 n ーー 
模 反 /数字 
IO 引 脚 


































数据 GPIO 输 入 
控制 图 GPIO 输 出 
GPIO 输 出 使 能 
EE 
中 断 
控制 


GPIODR4R 





GPIOIBE 
GPIOIEV 








GPIOPenphIDO 


GPIODRS8R 
GPIOSLR 


GPIOPUR 





GPIOPDR 
GPIOODR 





GPIODEN 





GPIOANSEL 


识别 寄存 器 


GPIOPenphID4 | | GPIOPenphIDO 





GPIOPenphID1 


GPIOPenphIDS | | GPIOPenphID1 





GPIOPenphID2 
GPIOPenphID3 GPIOPenphID7 | | GPIOPenphID3 


功能 简介 


1. 数据 控 制 


GPIOPenphID6 | | GPIOPenphID2 





模拟 电路 


ADC 

于 连接 到 

ADC 输 入 MUX 的 
GPIO 引 脚 ) 























图 5-1 


GPIO 模拟 /数字 口 模块 框图 





数据 控制 寄存 器 允许 软件 配置 GPIO 的 操作 横 式 。 当 数据 寄存 天 捕获 到 输入 数据 时 ， 数 
据 方向 寄存 右 将 GPIO 配置 为 输入 ;， 当 数据 寄存 器 通过 端口 输出 数据 时 ， 数 据 方向 寄存 器 将 


GPIO 配置 为 输出 。 
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(1) 数据 方向 操作 

GPIO 方向 寄存 器 (CPIODIR ) 用 于 将 每 个 独立 的 引 脚 配置 成 输入 或 输出 。 当 数据 方向 寄 
存 器 中 的 位 被 清 零 时 ， 则 配置 为 输入 ， 使 寄存 器 中 的 相应 位 捕获 并 储存 CPIO 端口 的 值 ， 当 数 
据 方向 寄存 器 中 的 位 被 置 位 时 ， 则 配置 为 输出 ， 数 据 寄 存 器 中 的 相应 位 便 可 驱动 CPIO 端口 。 

(2) 数据 寄存 器 的 操作 

为 了 提高 软件 的 效率 ， 可 将 地 址 总 线 上 的 [9:2] 位 用 作 屏 蔽 位 ， 对 GPIO 端口 的 数据 
寄存 器 (GPIODATA) 中 的 各 个 位 进行 修改 。 采 用 这 种 方式 使 软件 驱动 程序 仅 用 一 条 指令 就 
可 修改 任意 一 个 GPIO 引 脚 ， 而 不 会 影响 其 他 引 脚 的 状态 。 该 方式 与 通过 “ 读 - 修改 - 号 " 
来 操作 CPIO 引 脚 的 传统 做 法 不 同 。 为 了 实现 这 种 功能 ，GPIODATA 寄存 器 覆盖 了 存储 器 映 
射 中 的 256 个 单元 。 

在 进行 写 和 人 操作 时 ， 如 果 与 数据 位 相关 联 的 地 址 位 被 置 位 ， 则 GPIODATA 寄存 器 的 值 
将 相应 地 发 生变 化 ， 如 果 地 址 位 被 清 零 ， 那 么 数据 位 将 保持 不 变 。 

例如 ， 将 OxEB 写 入 到 地 址 CPIODATA +0x98 处 ， 其 结果 如 图 5-2 所 示 。 其 中 ，u 表示 
写 人 操作 没有 改变 数据 。 

在 进行 读 操 作 时 ， 如 果 与 数据 位 相关 联 的 地 址 位 被 置 位 ， 那 么 就 读 取 数 据 寄 存 器 中 的 
值 ; 如 果 与 数据 位 相关 联 的 地 址 位 被 清 零 ， 则 不 管 数 据 寄 存 器 中 的 实际 值 是 什么 都 读 取 0。 
例如 ， 读 取 地 址 GCPIODATA + 0x0C4 处 的 值 ， 其 结果 如 图 $-3 所 示 。 

ADDR[9:2] 9 8 7 6 5 4 3 2 1 0 ADDR[9:2] 9 8 7 6 5 4 3 2 1 0 
0x098 991119|9|1| 1|9| ofo| 
LTTTrTITI 
Llililolilelilil 

| + 

GpiopaTA [oTo yloi Tl 
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图 5-2 CPIODATA 写 人 示例 图 5-3 CPIODATA 读 取 示例 


2. 中 断 控 制 

每 个 GPIO 端 口 的 中 断 能力 都 由 7 个 寄存 器 控制 。 这 些 寄存 器 可 用 于 选择 中 断 源 、 极 性 
与 边沿 属性 。 当 一 个 或 多 个 输入 产生 中 断 时 ， 只 将 其 中 的 一 个 中 断 输出 ， 发 送 到 供 所 有 
GPIO 端口 使 用 的 中 断 控制 器 中 。 对 于 边沿 触发 ， 为 使 其 他 中 断 可 用 ， 软 件 必 须 清除 该 中 断 ; 
对 于 电 平 触发 ， 只 有 保持 外 部 电 平 的 状态 ， 才 能 使 控制 器 识别 中 断 的 发 生 。 

以 下 三 个 寄存 器 用 来 定义 中 断 触 发 的 边沿 或 测量 : 

① GPIO 中 断 检测 寄存 器 (CPIOIS) 。 

② GPIO 中 断 双 边沿 寄存 器 ( GPIOIBE ) 。 

③ CPIO 中 断 事件 寄 存 器 (CPIOIEV) 。 
通过 CPIO 中 断 屏 蔽 寄存 器 (CPIOIM ) 可 使 能 /禁止 中 断 。 当 产生 中 断 条 件 时 ， 可 在 
CPIO 原始 中 断 状态 寄存 器 (GPIORIS) 和 CPIO 屏蔽 后 的 中 断 状态 寄存 器 (CPIOMIS) 中 观 
察 到 中 断 信 号 的 状态 。 即 GPIOMIS 寄存 器 仅 显 示人 允许 被 传送 到 中 断 控 制 器 的 中 断 条 件 。 
GPIORIS 寄存 器 则 表示 CPIO 引 脚 满足 的 中 断 条 件 ， 但 不 一 定 发 送 到 控制 器 中 。 

注意 : 往 CPIO 中 断 清 零 寄存 器 (GPIOICR) 中 的 位 写 1 可 以 清除 相应 的 中 断 。 在 设置 中 
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斯 控制 寄存 器 (CPIOIS、CPIOIBE 或 GPIOIEV) 时 ， 应 该 保持 中 断 的 屏蔽 状态 (GPIOIM 清 
零 ) ， 如 果 相 应 的 位 没有 屏蔽 ， 那 么 向 中 断 控制 寄存 器 中 写 人 任何 值 都 有 可 能 产生 伪 中 晰 。 

(1) ADC 触发 源 

任何 CPIO 引 脚 都 可 以 使 用 GPIO ADC 控制 寄存 器 (GPIOADCCTL) 将 其 配置 成 ADC 的 
一 个 外 部 触发 。 如 果 任 一 CPIO 端口 被 配置 成 非 屏蔽 的 中 断 引 脚 ， 当 该 端口 产生 一 个 中 断 
时 ， 就 会 发 出 一 个 外 部 触发 信号 到 ADC。 此 时 如 果 ADC 事件 复 用 选择 寄存 器 (ADCEMUX ) 
被 配置 为 使 用 外 部 触发 器 ， 那 么 就 会 启动 ADC 转换 。 

(2) pDMA 触发 源 

任何 GPIO 引 脚 都 可 以 使用 CPIO DMA 控制 寄存 器 (GPIODMACTL) 配置 成 DMA 的 一 
个 外 部 触发 源 。 如 果 任 一 GPIO 端口 被 配置 为 非 屏 蔽 的 中 断 引 脚 ， 当 该 端口 产生 一 个 中 断 ， 
就 会 发 出 一 个 外 部 触发 信号 到 jkDMA。 如 果 根 据 CPIO 信号 nDMA 被 配置 成 启动 传输 ， 那 么 
就 会 启动 传输 。 

3. 模式 控制 

GPIO 引 脚 既 可 以 被 软件 控制 也 可 以 被 硬件 控制 。 大 部 分 的 引 脚 默认 为 软件 控制 ， 此 时 
GPIODATA 寄存 器 用 来 读 写 相应 的 引 脚 。 当 GPIO 复 用 功能 选择 寄存 器 (GPIOAFSEL) 使 能 
硬件 控制 时 ， 引 脚 状 态 将 由 它 的 复 用 ( 即 外 设 ) 功能 控制 。 

更 多 的 引 脚 复 用 功能 选择 由 CPIO 端口 控制 寄存 器 (GPIOPCTL) 提供 ， 该 寄存 器 可 为 
每 个 GPIO 选择 其 中 一 个 外 设 功能 。 注 意 : 如 果 一 个 引 脚 被 用 作 ADC 输入 ， 那 么 GPIOAM- 
SEL 寄存 器 中 相应 位 必须 被 置 位 来 禁止 模拟 隔离 电路 。 

4. 提交 (Commit) 控制 

CPIO 提交 控制 寄存 器 提供 的 保护 层 可 防止 对 重要 硬件 外 设 的 意外 编程 。 该 功能 可 保护 
4 个 JTAG/SWD 引 脚 (PC[3:0]) 与 NMI 引 脚 (PD7 和 PF0)。 向 CPIO 复 用 功能 选择 寄存 
器 (GPIOAFSEL) 、GPIO 上 拉 电 阻 选 择 寄存 (CPIOPUR ) 、GPIO 下 拉 电 阻 选择 寄存 带 
(GPIOPDR) 与 CPIO 数字 使 能 寄存 器 (GPIODEN) 中 受 保护 的 位 写 和 数据 将 不 会 被 确认 保 
存 ， 除 非 CPIO 锁定 寄存 器 (CPIOLOCK) 没有 被 锁定 ， 同 时 CPIO 提交 寄存 器 ( GPIOCR ) 
中 的 相应 位 被 置 位 。 

5. 引 脚 (Pad) 控制 

可 根据 应 用 程序 的 要 求 用 软件 来 配置 CPIO 引 脚 。 引 脚 控 制 寄 存 器 包括 CPIODR2R 、 
CPIODR4R 、CPIODR8R 、CPIOODR 、CPIOPUR 、CPIOPDR 、CPIOSLR 与 CPIODEN 寄存 器 。 
这 些 寄存 器 控制 着 引 脚 的 驱动 电流 大 小 、 开 漏 配 置 、 上 /下 拉 电 阻 的 选择 、 转 换 率 (slew - 
rate) 控制 和 数字 输入 使 能 等 。 如 果 在 配置 为 开 漏 输 出 的 CPIO 端口 上 加 上 SV 电压 ， 其 输出 
电压 将 取决 于 上 拉 电 阻 的 大 小 ， 而 没有 配置 的 CPIO 引 脚 将 输出 SV 电压 。 

6. 标识 

复位 时 配置 的 标识 寄存 器 允许 软件 将 模块 当 作 CPIO 块 进行 检测 和 识别 。 标 识 寄存 器 包 
括 GPIOPeriphIDO ~ CPIOPeriphID7 寄存 器 与 GPIOPCellIDO ~ GPIOPCellID3 寄存 器 。 


寄存 器 映射 及 寄存 堪 描 述 


1. 寄存 器 映射 
CPIO 中 包含 的 寄存 器 见 表 5-1。 每 一 个 CPIO 端口 都 可 通过 两 种 总 线 槽 访问 。 传 统 的 一 
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种 称 为 先进 外 设 总 线 (APB)， 同 后 兼容 以 前 的 产品 。 男 外 一 种 是 先进 高 端 总 线 (AHB ) , 


它 虽 和 APB 总 线 一 样 拥有 相同 的 寄存 器 映射 ， 却 提供 了 更 好 的 连续 访问 性 能 。 








表 5-1 GPIO 寄存 器 映射 




























































































































































































備 移 名 称 类 型 复 位 描 述 
0x000 GPIODATA R/W 0x0000.0000 GPIO 数据 寄存 器 
0x400 CPIODIR R/W 0x0000.0000 GPIO 方向 寄存 器 
0x404 GPIOIS R/W 0x0000.0000 GPIO 中 断 检 测 寄存 器 
0x408 GPIOIBE R/W 0x0000.0000 GPIO 双边 沿 
0x40C CPIOIEV R/W 0x0000.0000 GPIO 中 断 事件 寄存 器 
0x410 GPIOIM R/W 0x0000.0000 GPIO 中 断 屏 项 寄存 器 
0x414 CPIORIS RO 0x0000.0000 GPIO 原始 中 断 状 寄存 器 
0x418 CPIOMIS RO 0x0000.0000 GPIO 中 断 屏 项 状态 寄存 器 
0x41C GPIOICR WI1C 0x0000.0000 GPIO 中 断 清除 寄存 器 
0x420 CPIOAFSEL R/W 一 CPIO 复 用 功能 选择 寄存 器 
0xS00 GPIODR2R R/W 0x0000.00FF CPIO 2mA 驱动 选择 寄存 器 
0x504 GPIODR4R R/W 0x0000.0000 CPIO 4mA 驱动 选择 寄存 器 
0x508 GPIODR8R R/W 0x0000.0000 CPIO 8mA 驱动 选择 寄存 器 
0xS0C GPIOODR R/W 0x0000.0000 GPIO 开 漏 选 择 寄存 器 
0x510 GPIOPUR R/W 一 GPIO 上 拉 电 阻 选 择 寄 存 器 
0x514 CPIOPDR R/W Ox0000.0000 GPIO 下 拉 电 阻 选择 寄存 器 
0x518 CPIOSLR R/W 0x0000.0000 GPIO 斜率 控制 选择 寄存 器 
0x51C GPIODEN R/W 一 GPIO 数字 使 能 寄存 器 
0x520 GPIOLOCK R/W Ox0000.0001 GPIO 锁定 寄存 器 
0x524 GPIOCR 一 一 GPIO 提交 寄存 器 
0x528 CPIOAMSEL R/W 0x0000.0000 GPIO 模拟 选择 寄存 器 
0x52C GPIOPCTL R/W 一 GPIO 端口 控制 寄存 器 
0x530 GPIOADCCTL R/W Ox0000.0000 GPIO ADC 控制 寄存 器 
0x534 GPIODMACTL R/W Ox0000.0000 CPIO DMA 控制 寄存 器 
OxFDO GPIOPeriphID4 RO 0x0000.0000 GPIO 外 设 标识 寄存 器 4 
OxFD4 GPIOPeriphIDS RO 0x0000.0000 CPIO 外 设 标识 寄存 器 5 
OxFD8 GPIOPeriphID6 RO 0x0000. 0000 GPIO 外 设 标识 寄存 器 6 
OxFDC GPIOPeriphID7 RO 0x0000.0000 CPIO 外 设 标识 寄存 器 7 
OxFEO GPIOPeriphIDO RO 0x0000. 0061 GPIO 外 设 标识 寄存 器 0 
OxFE4 GPIOPerphID1 RO 0x0000.0000 CPIO 外 设 标识 寄存 器 1 
OxFE8 GPIOPeriphID2 RO 0x0000.0018 GPIO 外 设 标识 寄存 器 2 
OxFEC GPIOPeriphID3 RO 0x0000.0001 CPIO 外 设 标识 寄存 器 3 
GPIOPrimeCell 
OxFFO GPIOPCellIDO RO 0x0000. 000D 标识 寄存 器 0 
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( 续 ) 


























OxFF4 GPIOPCellID1 RO 0x0000. 000F0 GPIOPrimeCell 

标识 寄存 器 1 

OxFF8 GPIOPCellID2 RO 0x0000.0005 GPIOPrimeCell 
外 设 标 识 寄 存 器 2 

OxFFC GPIOPCellID3 RO 0x0000.000B1 GPIOPrimeCell 
外 设 标 识 寄存 器 3 


下 面 给 出 各 个 GPIO 端口 的 基地 址 和 偏 移 量 : 


e CPIO 端口 A (APB) : 0x4000.4000。 
e CPIO 端口 A (AHB) : 0x4005. 8000。 
e GPIO 端口 B (APB) : 0x4000. 3000 。 
e GPIO 端口 B (AHB) : 0x4005. 9000 。 
e GPIO 端口 C (APB) : 0x4000.6000。 
e GPIO 端口 C (AHB) : 0x4005. A000。 
e CPIO 端口 D (APB) : 0x4000.7000。 
e GPIO 端口 D (AHB) : 0x4005. B000。 
e CPIO 端口 E (APB) : 0x4002. 4000 。 
e GPIO 端口 E (AHB) : 0x4005. CO00。 
e GPIO 端口 了 (APB) : 0x4002. 5000。 


e CPIO 端口 F (AHB): 0x4005. D000。 

2. 几 个 常用 的 寄存 器 描述 

(1) GPIO 端口 控制 寄存 器 (GPIOPCTL) ， 偏 移 量 0x52C 

GPIOPCTL 寄存 器 与 GPIOAFSEL 寄存 需 协 作为 每 个 GPIO 引 脚 ( 当 使 用 食用 功能 模式 
时 ) 选择 具体 的 外 设 信号 。GPIOAFSEL 寄存 器 中 大 部 分 的 位 在 复位 时 是 清 零 的 ， 所 以 大 部 
分 CPIO 引 脚 默认 配置 为 CPIO 功能 。 在 CPIOAFSEL 寄存 器 中 某 位 被 置 位 时 ， 表 示 相 应 的 
GPIO 引 脚 由 相关 外 设 控制 。GPIOPCTL 寄存 器 可 以 为 每 个 CPIO 引 脚 选择 使 用 何 种 外 设 功 
能 ， 因 此 在 信号 定义 时 提供 了 高 度 的 灵活 性 ， 如 图 5-4 所 示 。 


31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
PMC7 PMC6 PMCS PMC4 


类 型 RW RW RW RW RW RW RW RW RW RW RW RW RW RW RW RW 
复位 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


类 型 RW RW RW RW RW RW RW RW RW RW RW RW RW RW RW RW 
复位 























图 5-4 端口 控制 寄存 器 (GPIOPCTL) 


位 /字段 ”名称 类 型 复位 描述 


31. 28 PMC7  R/W 端 日 臭 用 控 制 各 7 
该 区 域 的 值 控制 着 端口 7 的 配置 
27. 24 PMC6 R/W 端口 复 用 控制 髓 6 
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该 区 域 的 值 控制 着 端口 6 的 配置 

15: 12 PMC3  R/W ー 端口 复 用 控制 器 3 
该 区 域 的 值 控制 着 端口 3 的 配置 
11: 8 PMC2 R/W 国 端口 复 用 控制 器 2 
该 区 域 的 值 控制 着 端口 2 的 配置 
7: 4 PMC1 R/W ー 端口 复 用 控制 器 1 
该 区 域 的 值 控制 着 端口 1 的 配置 

3: 0 PMCO _ R/W = 端口 复 用 控制 器 0 

该 区 域 的 值 控制 着 端口 0 的 配置 

(2) CPIO 数据 寄存 器 (CPIODATA) ， 偏 移 量 0x000 

在 软件 控制 模式 中 ， 如 果 通 过 CPIO 方向 寄存 器 (GPIODIR) 将 各 个 引 脚 配置 成 输出 ， 
那么 写 入 CPIODATA 寄存 器 的 值 将 被 发 送 到 CPIO 端口 引 脚 上 。 

为 了 对 GPIODATA 寄存 器 执行 写 和 操作， 由 地 址 总 线 位 [9:2] 产生 的 相关 屏蔽 位 必须 
被 置 位 。 否 则 ， 位 的 值 不 会 被 写 和 操作 改变 。 

同样 ， 从 该 寄存 器 读 取 的 值 由 从 访问 数据 寄存 器 的 地 址 处 获取 的 屏蔽 位 [9:2] 的 情況 
来 决定 。 如 果 地 址 屏 项 位 为 1, 那么 读 取 CPIODATA 中 相应 位 的 值 ， 如果 地 址 屏蔽 位 为 0, 
那么 不 管 CPIODATA 中 相应 位 的 值 是 什么 ， 读 取得 到 的 结果 都 是 0。 

如 果 各 自 的 引 脚 被 配置 成 输出 ， 那 么 读 取 CPIODATA 将 返回 最 后 写 和 的 位 值 ; 或 者 当 
这 些 引 脚 被 配置 成 输入 时 ， 将 返回 相应 的 输入 引 脚 上 的 值 。 复 位 时 所 有 的 位 都 是 清 零 的 ， 如 
图 5-5 所 示 。 


















































31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 
保留 
类 型 RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO 
复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
保留 DATA 
类 型 RO RO RO RO RO RO RO RO RW RW RW RW RW RW RW RW 
复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


图 5-5 GPIO 数据 寄存 器 (GPIODATA) 


位 /字段 ”名称 类 型 复位 描述 

31: 8 保留 ”RO 0x0000. 00 软件 不 可 依赖 保留 位 的 值 。 为 了 兼容 未 来 的 
产品 ， 保 留 位 的 值 在 读 取 -修改 - 号 人 操作 
过 程 中 应 保持 不 变 

7: 0 DATA RW 0x00 GPIO 数据 
该 寄存 器 被 虚拟 地 映射 到 地 址 空间 的 256 个 单 
元 中 。 为 便于 通过 单独 的 驱动 器 读 写 这 些 寄存 
器 ， 从 其 读 取 的 值 和 写 和 人 其 中 的 值 可 通过 8 条 
地 址 线 [9: 2] 屏蔽 。 读 取 该 寄存 器 将 返回 其 
当前 状态 。 写 人 该 寄存 器 仅 影 响 那些 没有 被 
ADDR [9: 2] 屏蔽 的 位 和 被 配置 成 输出 的 位 
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(3) GPIO 方向 寄存 器 (GPIODIR) , 偏 移 量 0x400 

在 GPIODIR 寄存 器 中 的 某 位 被 置 位 会 将 相应 的 引 脚 配置 成 输出 ， 而 清 零 的 话 就 是 配置 
为 输入 。 复 位 时 ， 所 有 的 位 都 被 清 零 ， 这 意味 着 所 有 GPIO 端口 默认 为 输入 状态 ， 如 图 $-6 
所 示 。 


31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 











类 型 RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO 
复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 


15 14 13 2 11 10 9 8 7 6 a 4 3 め 0 
美 型 RO RO RO RO RO RO RO RO RW RW RW RW RW RW RW RV 
复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

图 5-6 GPIO 方向 寄存 器 (GPIODIR) 
位 /字段 名 称 类 型 复位 描述 


31: 8 保留 ” RO 0x0000. 00 软件 不 可 依赖 保留 位 的 值 。 为 了 兼容 未 来 的 
产品 ， 保 留 位 的 值 在 读 取 -修改 - 写 入 操作 
过 程 中 应 保持 不 变 
7: 0 DIR R/W Ox00 GPIO 数据 方向 
值 ” 描 述 
0 ”相应 的 引 脚 为 输入 
1 ”相应 的 引 脚 为 输出 
(4) GPIO 中 断 事 件 寄 存 器 (GPIOIEV) ， 偏 移 量 0x40C 
当 GPIOIEV 寄存 器 中 某 位 被 置 位 时 ， 相 应 的 引 脚 由 上 升 沿 或 是 高 电 平 触发 中 断 ， 具 体 由 
GPIO 中 断 检测 寄存 器 (CPIOIS) 中 的 位 控制 。 清 零 一 个 位 则 表示 相应 的 引 脚 由 下 降 沿 或 是 低 
电 平 触 发 ,具体 还 是 由 CPIOIS 中 的 位 控制 。 复 位 时 所 有 的 位 都 是 清 零 的 ， 如 图 $-7 所 示 。 
31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 


类 型 RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO 











复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 
保留 IEV 

类 型 RO RO RO RO RO RO RO RO RW RW RW RW RW RW RW RW 

复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 








图 5-7 GPIO 中 断 事件 寄存 器 (CPIOIEV) 

位 /字段 “名 称 类 型 复位 描述 

31: 8 保留 ”RO 0x0000. 00 软件 不 可 依赖 保留 位 的 值 。 为 了 兼容 未 来 的 
产品 ， 保 留 位 的 值 在 读 取 -修改 - 写 和 人 操作 
过 程 中 应 保持 不 变 

7: 0 IEV R/W Ox00 CPIO 中 断 事件 
值 ”描述 
0 ”相应 引 脚 上 的 下 降 沿 或 低 电 平 触 发 中 断 
1 ”相应 引 脚 上 的 上 升 沿 或 高 电 平 触发 中 断 
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(5) CPIO UR (GPIOAFSEL) ， 偏 移 量 0x420 

如 果 某 位 被 清 零 ， 则 表示 相应 的 引 脚 用 作 CPIO 功能 ， 并 受 CPIO 寄存 器 控制 。 某 位 被 
MRR 0 GPIO 线 受 相关 外 设 控制 。 每 个 GPIO 上 都 有 几 个 不 同 的 复 用 外 设 功能 。 
可 以 通过 CPIO 端口 控制 寄存 器 (CPIOPCTL) 来 选择 其 中 的 一 个 所 需 的 功能 ， 如 图 5-8 
所 示 。 














洪 
更 


类 型 RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO RO 














复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
15 14 13 12 11 10 9 8 2 6 5 4 3 2 1 0 
类 型 RO RO RO RO RO RO RO RO RW RW RW RW RW RW RW RVW 
复位 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 
图 5-8 复 用 功能 选择 寄存 器 (GPIOAFSEL) 
位 /字段 名 称 类 型 复位 描述 


31: 8 ”保留 RO 0x0000.00 软件 不 可 依赖 保留 位 的 值 。 为 了 兼容 未 来 的 产品 ， 
保留 位 的 值 在 读 取 - 修改 - 写 入 操作 过 程 中 应 保 
持 不 变 

7: 0 AFSEL R/W - 复 用 功能 选择 
值 “描述 
0 ”相应 引 肢 为 CPIO 功能 ， 受 CPIO 寄存 器 控制 
1 ”相应 引 脚 为 外 设 功 能 ， 由 复 用 硬件 功能 控制 


GPIO 的 API 分 为 三 个 函数 组 : 
① 配置 GPIO 引 脚 。 

② 中 断 处 理 。 

③ 访问 引 脚 状态 。 

(1) 配置 GPIO 引 脚 的 常用 函数 
e CPIODirModeSet( ) 。 

e CPIOPadConfigSet( ) 。 

e CPIOPinConfigure( ) 。 

e CPIODirModeGet( ) 。 

e GPIOPadConfigGet( ) 。 

e CPIOPinTypeCAN( ) 。 

e CPIOPinTYypeComparator( ) 。 

e CPIOPinTypeGPIOInput( ) 。 

e CPIOPinTypeGPIOOutput( ) 。 

e CPIOPinTypeGPIOOutputOD( ) 。 


e CPIOPinTypel2C( ) 。 

e CPIOPinTypePWM( ) 。 

e CPIOPinTypeOEI( ) 。 

e CPIOPinTypeSSI( ) 。 

e CPIOPinTypeTimer( ) 。 

e CPIOPinTypeUART( ) 。 

(2) 中 断 处 理 的 常用 函数 

e GPIOIntTypeSet( ) 。 

e GPIOIntTypeGet( ) 。 

e CPIOIntEnable( ) 。 

e CPIOIntDisable( ) 。 

e CPIOIntStatus( ) 。 

e CPIOIntClear( ) 。 

e CPIOIntRegister( ) 。 

e CPIOIntUnregister( ) 。 

(3) 访问 GPIO 引 脚 状态 的 函数 
e CPIOPinRead( ) 。 

e CPIOPinWrite( ) 。 

详细 的 GPIO 固件 库 函 数 功能 介绍 请 


SY 
i 
而 
Th 
至 
池 
C39 





本 小 节 将 以 两 个 非常 简单 的 闪烁 灯 实 验 来 介绍 基于 寄存 器 和 基于 固件 的 GPIO 模块 的 编 
程 方法 ， _ 以 及 较 详细 的 调试 过 程 。 

1. 三 只 LED 同时 闪烁 的 程序 (寄存 器 ) 

1) EK -TM4C123GXL 开发 板 三 只 LED 的 硬件 连接 图 如 图 5-9 所 示 。 

2) LED 闪烁 程序 。LED 闪烁 的 程序 流程 图 如 图 5-10 所 示 。 


同时 点 亮 3 只 LED 


环 〈 延 时 ) 





























TM4C123 る 5 
Bi LUSR SW? 同 熄灭 3 只 LED 
= EN 
uu fT 循环 ( 延 时 ) 
LEVD 
ER ET 
エー < USR SWL 空 

















图 5-9 TM4C123GXL 开发 板 三 只 LED 的 硬件 连接 图 图 5-10 LED 闪烁 程序 流程 图 
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// ホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポ ホ ポポ ホホ ポポ ホ ポポ ホホ ポポ ポポ ホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ 
// 文 件 名 : threeblinky. c 
// 来 源 :根据 TI 例 程 改编 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ボネ ポポ ボネ ポポ ポポ ポポ 


#include < stdint. h > 
#include "inc/tm4c123gh6pm. hy" 


int 


main( void ) 


| 


volatile uint32_t ui32LEDloop: 
六 

// 使 能 CPIOF 端口 
“A 
SYSCTL_RCGC2_R = SYSCTL_RCGC2_GPIOF; 

A 

// 使 能 外 设 后 插入 几 个 周期 的 空 读 取 操 作 

ググ 

ui32LEDloop = SYSCTL_RCGC2_R: 

// 

// 使 能 PF1(LED_R) 、PF2(LED_B) .PF3(LED_G) 引 脚 
// 设 置 这 些 引 脚 为 输出 

// 使 能 这 些 引 脚 的 数字 功能 

HY 

GPIO_PORTF_DIR_R = 0x0e; 

GPIO_PORTF_DEN_R = 0x0e; 

4 

// 无 限 循环 ( 主 循环 ) 

A 

while( 1) 

| 
































// 点 亮 三 只 LED 灯 


GPIO_PORTF_DATA_R | =0x0e: 

Xf 

// 延 时 (循环 ) 

;bp 

for( ui32LEDloop =0;ui32LEDloop <200000 ; ui32LEDloop ++ ) 
| 


// 
// 熄 灭 三 只 LED 灯 

// 

GPIO_PORTF DATA R &= ~ (0x0e) ; 
// 

// 延 时 (循环 2) 
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// 

for( mn32LEDloop =0;ui32LEDloop <200000 ; ui32LEDloop ++ ) 
| 

| 


| 
3) 在 Keil ARM 中 创建 threeblinky_r 工程 ， 如 图 5-11 所 示 。 





r 1 
Wd CAti\TivaWare_C_Series-1.0\exam ples\boards\my_Keil_board\threeblinky\threebli ne 




















File Edit View Project Flash Debug Peripherals Tools SVCS Window Help 
门 臣 回血 | % 十 哆 | 9 | 但 

に 出 を E30 時 | threeblinky_r 区 起 | 重吉 を 向 
Project 『 图 | は ] threeblinky.c |[ ま ] startup TM4C123.s 













小 に まま まま 、 ま まま あま 、 る を 、 ま まる る 、 を まま. る る. ま 、 る まま る 3 


2// 文件 名 :threeb1inky.c 


3 たよ よ よ よ よ よ よ よ よ よ よさ と よ な と と な と と と と よ と と よ と よ と と と と 





日 -人 富 Source 
国 startup_TM4C123.s 
划 threeblinky.c 

















5 #1nc1ude <stdint.h> 
6 #include "1nc/tm4c123qh6pm .h" 











图 5-11 创建 的 闪烁 灯 工 程 ( 寄 存 器 ) 
4) 编译 threeblinky_r 工程 生成 可 执行 的 . axf 格式 文件 ， 如 图 5-12 所 示 。 


Build Output 再 
编译 结果 回 







Rebuild target 'threeblinky エリ 
lassembling startup TM4C123.5... 

lcompiling threeblinky.c... 

linking... 

IProgram Size: Code=1060 RO-data=16 RW-data=0 ZI-data=608 
" . \threeblinky.axf" - 0 Errors, 0 Warning(s). 





器 








5-12 ”编译 结果 


5) 在 EK - TM4C123GXL 板 上 对 程序 进行 调试 与 测试 。 
① 调试 。 单 击 工具 栏 中 的 下 图 标 ， 调 出 调试 窗口 ， 如 图 $-13 所 示 。 
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CiVMivaWare_C_ Series-1.0vexamples\boardswny_Keil_boardvhreeblinkyuhreeBlink.… Ee 
File Edit View Project Flash Debug Peripherals Tools SVCS Window Help 

















i 门 营 回 入 | 三 区 | | | 和 | 熏 理 上 咎 卡 | 吵 1 
邊 | 色 @| 包 で や 9|s ぁ | 回 園 品 国 因 品 - 国 ココ 避 - 本 - 回 - 男 ・ x 下 





Registers ? 国 Disassembly 于 


[Register |yalue | 





Ox00000000 0260 
0x00000002 2000 























RO Oxo0000000 
R1 oxo0000000 
-R2 DOxoooooooo0 一 
a Ox00000000 
Rd 0x00000000 9main (void) = 
R5 ox00000000 10 回 
-Re oxo0000000 . . . 
|: R7 Ox00000000 11 volatile uint32 t ui32LEDloop; 
i R8 0x00000000 。_ 12 // i ee 
= っ a aaannn | 13 // 使 能 GPIOF 端 口 Se 
国 | Project 时 Registers 四 | ト 








器 





$-13 ”调试 窗口 








单 击 工具 栏 中 的 庆 - 图 标 右 侧 的 三 角 ， 按 图 $-14 所 示 过 程 调 出 GPIOF 端口 ， 以 便 在 调 
试 中 观察 DATA 的 变化 情况 。 











WarcHpoc »| 


GPIOA 














YS? GPIOB 
UART NV GPIOC ; ONE Id 
12C y 1 GPIOD IDATA Ox00000000 
| PWM pTO DIR 10x00000000 
| NCEP 3 IS 0x00000000 
TIMER 2 POA_AHB IBE 0x00000000 
ADC » GPIOB AHB IEV Ox00000000 
由 -JM 
COMP GPIOC_AHB 











5-14 选中 CPIOF 端口 的 过 程 
右键 单 击 将 ui32LEDloop 变量 添加 到 观察 窗口 ， 如 图 5-15 所 示 。 


















| 单 击 右 键 添加 
ui32LEDloop 
到 观察 窗 


1 
ww Definition Of 'ui32LEDloop" Call Sta Locals Memon 
e Go To Reference To ui32LEDloop" 


が 
3 expression™ Add'ui32LEDloop' to, ー ニ ーーーー 移 - 


































Watch 2 











Stack + Locals | Insert Tracepoint at ui32LEDloop…. 3 
| Enable/Disable Tracepoint Memory 1 
PR Insert/Remove Bookmark Ctrl+F2 Memory 2 





图 5$-15 添加 ui32LEDloop 变量 到 观察 窗口 的 过 程 





单 击 工具 栏 的 全 速 运行 按钮 恩 启 动 调试 ， 其 结果 如 图 $-16 所 示 。 
EEC A i EM ME A NII oo 


大 threeblinky.c 图 startup_TIY 数据 在 0 到 14 之 间 号 X | GPIOF 3 ] 
nT 间 吕 的 变化 。 ~ = 4 
Value 














Registers 



































9 mai i ~~ 

main (void) 和信 po 5 
10{ 
11 volatile uint32 t ui32LEDloop; 

or20000060™ | 12 // 記 












as 选中 GPIO 输 出 一 一 一 






Dx20000060 








SLR 0x00000000 
数字 使 能 “一 一 一 一 若 |DEN |0x0000000E 
-| 6 


| 4 
.) 


T 
ype 


Fh 

Stack 
States 0 で 
Sec 0. 00000000 | 


pr 















詩 Registers 





Command 





Connecting: Mode=JTAG, Speed=1000000HzLoad "C:\\ti\\TivaWare a Name 
WS 1, ‘ui32LEDloop 


WS 1, ‘SYSCTL RCGC2 R 司 Y ui32LEDIoop unsigned in 
WS 2, ‘ui32LEDloop <Enter expression> 
ui32LEDloop=200000 








reece ER 


5-16 全速 运行 结果 
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从 DATA 、 DIR 、RO 等 寄存 器 中 的 值 和 EK - TM4C123CXL 板 上 的 运行 结果 来 看 ， 三 灯 
同时 闪烁 程序 是 正确 的 。 下 面 将 以 单 步 运行 方式 来 验证 程序 的 运行 情况 是 否 符合 程序 设计 


思 相 . 


PvP。 


单 击 工具 栏 中 的 复位 图 标 器 | 使 循环 计数 寄存 器 RO 清 零 ， 让 程序 回 到 Startup _ 
TM4C123G. s (如 图 5-17 所 示 ) 的 双 三 角 位 置 。 











辕 threeblinky.c* 。 | 上 startup_ TM4C123.s ¢| 
is project. 
BD 258 MOVW RO, #0xED88 
259 MOVT RO, #0xE000 
260 LDR Rl, [RO] 
261 ORR Rl, #0x00F00000 
262 STR Rl, [RO] 
アーム ノム ナグ ょ 、 プ ーーーー 
と ビィ ィ ・ り SS さき ビビ ヒレ ーー11 < 有 
268 5 
269 IMPORT main 
270 B _ main 
二 了 次 内资 次 次 次 次 沉 风 山 资 次 风 资 涡 涡 次 次 次 次 次 次 党 帘 痪 迪 次 次 帘 资 奖 奖 
Text Editor i Configuration Wizard / 











图 5-17 初始 化 代码 


然后 单 击 (Fl11〉 键 单 步 运 行 这 段 程序 ， 当 程序 运行 到 270 行 ( 即 B_main) 时 ,将 光 
标 放 置 在 threeblinky. c 的 main 函数 处 ， 然 后 按 工具 栏 中 的 后 图标， 让 程序 运行 到 光标 处 ， 
使 程序 从 main 函数 处 开始 执行 ， 以 便 观察 DATA 和 ui32LEDloop 变量 的 变化 情况 (这 时 DA- 
TA =0x00000000 、DIR =0x00000000 、RO =0x20000060 和 ui32LEDloop = 0x00000000) 。 

按 〈FI1) 键 继续 单 步 执行 ， 当 程序 运行 到 mi32LEDloop = SYSCTL_RCGC2_R 处 时 ，RO 
=0x00000020。 

说 明 : 此 时 已 使 能 GPIOF 端口 。 

然后 继续 单 步 执行 ， 以 观察 程序 运行 的 结果 ， 当 程序 和 运行 到 for (ui32LEDloop = 0: 
ui32LEDloop <200000 ; ui32LEDloop ++ ) 语句 处 时 ， 为 了 使 程序 退出 数 万 次 的 循环 ， 可 在 命 
令 行 输入 mi32LEDloop =200000 命令 (如 图 5-18 所 示 ) 使 程序 从 空 操作 中 退出 。 再 继续 单 
步 执行 以 观察 程序 运行 状况 。 


u132LED1oop=200000 
‘ \ 


>ui32LEDloop=200000 


<C=style expression> Variable = <expression> 

















图 5-18 从 命令 行 输 入 计数 器 最 大 值 





小 结 : 读者 可 从 这 个 简单 的 例子 中 学 会 如 何 进 行 单 步调 试 程序 的 方法 。 
@ 测试 。 导 入 编译 产生 的 .axf 文件 到 EK - TM4C123CXL 中 ， 其 运行 及 测试 结果 如 
图 $-19 所 示 。 
の 
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图 5-19 EK -TM4C123GXL 开发 板 测试 结果 


从 图 $-19 的 测试 结果 来 看 ， 开 发 板 能 同时 发 出 比较 炫目 的 白色 光芒 ， 验 证 了 基于 寄存 
器 的 三 灯 同 时 闪烁 程序 是 正确 的 (R、G、B 三 色 发 光 管 同时 发 光 应 该 是 白光 ， 这 里 只 是 近 
似 白 色 ， 这 是 由 于 三 色 的 比较 不 对 ) 。 

2. 三 只 LED 同时 闪烁 程序 ( 固件 库 ) 

1) LED 程序 。 





// 六 米 米 六 六 六 六 六 米 六 六 洲 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 
// 文 件 名 :threeblinky_f c 
// 来 源 : 根 据 TI 例 程 修改 


// ネネ ネネ ネネ ボボ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ 


#include < stdint. h > 

#include < stdbool. h > 
#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/ gpio. h" 


uint8_t ui8PinLEDdata =7: // 设 置 LED 数据 并 初始 化 


int main( void ) 


| 




















// 
// 设 置 系统 时 钟 :5 分 配 、 使 用 PLL、 外 接 16 MHz 晶振 使 用 主 振荡 器 
// 


SysCtlClockSet( SYSCTL_SYSDIV_5 | SYSCTL_USE_PLL | SYSCTL_XTAL_16MHZ | 
SYSCTL_OSC_MAIN) ; 

// 

// 使 能 外 设 GPIOF 端口 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOF) ; 

// 





93 


94 


// 将 FP1 、FP2 、FP3 端口 设置 为 输出 

// 

GPIOPinTypeGPIOOutput( GPIO_PORTF_BASE, GPIO_PIN_1 | GPIO_PIN 2 | GPIO_PIN_3); 
// 

// 无 限 循 环 

// 

while(1) 

| 





メ / 
/人 /同时 点 亮 三 只 LED 
メ / 
GPIOPinWrite ( GPIO _ PORTF _ BASE, GPIO _ PIN _1 | GPIO _ PIN _2 | GPIO _ PIN _3, 
ui8PinLEDdata) ; 
// 
// 延 时 
// 
SysCtlDelay (2000000 ) ; 
// 
// 同 时 熄灭 三 只 LED 
メ / 
GPIOPinWrite( GPIO_PORTF_BASE,CPIO_PIN_1 | GPIO_PIN 2 | GPIO_PIN_3,0x00 ) ; 
// 
// 延 时 
ノ // 
SysCIDelay(2000000 ) ; 





| 
2) 创建 hreeblinkyf 工程 〈 固 件 库 ) ， 如 图 5$-20 所 示 。 





TT 
EA CAti\TivaWare_C_Series-1.0\examples\boards\my_Keil_board\GPIO_three\GPIO_three 





File Edit View Project Flash Debug Peripherals Tools SVCS Window Help 








ロロ gl| 品 | 2 =| 和 内 这 牛牛 | 哄 
SS | 峰 | threeblinky- ”| 起 | 晶 名 专人 盖 




















4 图 曲 startup_TM4C123.s threeblinky_f.c 
1 #1 e <stdint.h> 
= <stdbool.h> 
"inc/hw memmap.h" 
"inc/hw types.h" 
"driverlib/sysctl.h" 
"driver1ib/qpio.h" 





















日 < SOurce 
ー 回 startup_ TIM4C123.s 


= 4 #incl 
蚜 threeblinky_fc 5 








“所 Libraries 
因 driverlib.lib 





















图 $-20 创建 的 threeblinky_f 工程 (固件 库 ) 





工程 的 创建 过 程 如 下 : 

① 添加 threeblinky. c 到 工程 中 。 

② 增加 库 函 数组 ， 并 将 驱动 库 添加 到 工程 中 。 

③ 添加 头 文件 及 库 文 件 搜 索 路 径 ， 如 图 5-21 所 示 。 


Options for Target 'threeblinky' 


Device | Target | Output | Listing| Tser Lee bs | Linke 


ー Preprocessor Symbols 


Define: 

、Un 
人 添加 头 文件 与 库 【 、 
文件 搜索 路 径 


















| | oneELF Secton per Function 
一 一 一 一 





Misc |_cgg 
Controls 











图 5-21 添加 头 文件 及 库 文 件 搜索 路 径 
说 明 : 如 果 程 序 中 有 打 甘 的 代码 行 存在 ， 很 多 情况 下 就 是 由 于 程序 无 法 找到 头 文件 或 库 
文件 造成 的 ， 这 时 可 以 考虑 重新 设置 搜索 路 径 。 
④ 添加 startup. s 文件 。 详 细 的 操作 过 程 请 参考 第 1 章 Keil ARM 的 使用 方 法 。 
3) 编译 工程 ， 其 结果 如 图 $-22 所 示 。 








Build Output A 四 | 

& 编译 结果 上 生成” 图 
Rebuild target 'threeblinky f£" f 入 
assembling startup TM4C123.s... = = % 文件 
compiling threeblinky f.c... = 

> = = 

linking... - レコ 
Program ebede=16 地 -data=32 RW-data=4 ZI-data=612 
"NGPIO three.axf™ 


0 Errors, 0 Warning(s). 


5-22 threeblinky_ f 工 程 的 编译 结果 


4) 在 EK - TM4C123GXL 开发 板 上 对 程序 进行 测试 。 导 入 编译 产生 的 . axf 文件 到 EK - 
TM4C123GXL 板 中 ， 其 运行 及 测试 结果 如 图 $-23 所 示 。 


司 山 
于 仁 
近 品 


EK-TM4C1236XL ~ 


一 9 


で 
に 
2. 
3 
3 
所 
与 
ーー 
ヨ 
に 
局 
ビー 
日 
¥ 





5-23 FEK - TM4C123GXL 开发 板 测 试 结 果 


从 图 5-23 的 测试 结果 来 看 ， 开 发 板 能 同时 发 出 比较 炫目 的 白色 光芒 ， 验 证 了 所 创建 的 
threeblinky_f 工程 实现 了 设计 思想 。 
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3. 在 Proteus 上 测试 流水 灯 程 序 
1) 流水 灯 程 序 。 


メ / ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ※ ネ 玉 
//Hiushuideng. c 

// 来 源 :根据 TI 例 程 改编 

// 功 能 :在 Proteus 虚拟 硬件 平台 上 实现 对 流水 灯 程 序 的 测试 

// 作 用 :对 无 真实 板 卡 和 有 某 款 开发 板 但 缺少 外 设 的 读者 验证 自己 

// 所 编程 序 之 正 误 


// * ま ポポ ネ ポポ ※ ポ 六 玉 玉 ※ ポ ポポ * 玉 ドド ポポ ポポ ボド ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ 








#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/debug. hy" 
#include "driverlib/gpio. h" 
#include " driverlib/sysctl hy" 
#include " driverlib/systck. h" 


// ネネ ネネ ネネ ボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ 



































// 

// 设 置 用 于 LED 显示 的 GPIO 引 脚 

// 

// ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ホ ポポ ポポ ポポ ポポ ホ ポポ ポポ ネネ 
#define PINS (CPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN 2 | CPIO_PIN_3 |\ 





GPIO_PIN_4 | GPIO_PIN_S | CPIO_PIN_6 | GPIO_PIN_7) 


// * ま まま ポ ネ ポポ ポポ ポポ ギド 六 玉 洲 ポ ポポ ポポ ポポ ポポ ポポ ポ ポポ ポポ ポ ネネ ポポ ネ ポポ ポポ ポポ ポポ 


// 下 面 将 使 用 固件 库 CPIOPinTypeCPIOOutput( ) 函数 实现 8 LED 流水 


// ネネ ネネ ボ ポポ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ポポ 























int 
main( void ) 
| 
// 
// 设 置 系统 时 钟 
// 
SysCIClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_O0SC_MAIN | 
SYSCTL_XTAL_6MHZ) : 





// 

// 使 能 CPIO 模块 

// 

SysCLPeripheralfnable( SYSCTL_PERIPH_CPIOB ) ; 





pp 
// 设 置 CPIO 为 输出 端口 

// 

GPIOPinTypeGPIOOutput( CPIO_PORTB_BASE,PINS ) ; 





while(1) 


// 

// 点 亮 LED1 

// 

CPIOPinWrite( GPIO_PORTB_BASE ,PINS ,0x01) ; 

// 

// 延 迟 , 由 于 是 软件 模拟 LM3S301 ,因此 运行 速度 比 实际 慢 得 多 
// 这 里 延迟 的 时 钟 个 数 比 真实 CPU 少 得 多 ,请 读者 注意 

// 





SysCtlDelay(15000 ) ; 

// 

// 点 亮 LED2 

// 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x02) ; 
SysCLDelay(13000 ) ; 

だ 

// 点 館 LED3 

ZZ 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x04) ; 
SysCHDelay(13000 ) ; 

// 

// 点 亮 LED4 

// 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x08) ; 
SysCHDelay(13000 ) ; 

// 

// 点 館 LEDS 

// 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x10) ; 
SysCIDelay(13000) ; 

// 

// 点 館 LEDe 

// 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x20) : 
SysCIDelay(13000 ) ; 

メグ だ 

// 点 亮 LED7 

// 

CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x40 ) : 
SysCHDelay(13000 ) ; 

メ / 

// 点 館 LED8 

// 


CPIOPinWrite( CPIO_PORTB_BASE,PINS.0x80) ; 
SysCIDelay(13000 ) ; 
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2) 搭建 测试 电路 图 。 流 水 灯 程 序 的 测试 电路 如 图 5-24 所 示 。 









LM3S301 


TEXT 





图 5-24 流水 灯 程 序 的 测试 电路 





PDO/PWMO 


PA1/UOTX PD1/PWM1 
PA2/SSICLK PD2 
PA3/SSIFSS PD3 
PA4/SSIRX PD4 
PA5/SSITX PD5/CCP2 
PBO/CCPO PD67FAULT 
PB1 PD7/COo 
PB2 PE0 
PB3 PE1 
PB4/CO- 

PB5/C1- ADCO 
PB6/CO+ ADC1 
PB7/TRST ADC2 
PCOTCKISWCLK ADC3 
PC17TMS/SWDIO 

PC27TDI 

PC3TDO/SWO 

PC4 LDO 
PC5/C1+/C1o RST 
PC6 OSC0 
PC7 OSC1 
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に bi に pF EE に に に RS 
回 Eee 


四 下 四 四 
EH | 





3) 流水 灯 程 序 的 测试 结果 。 流 水 灯 程 序 的 测试 结果 如 图 5-25 所 示 。 























图 $-25 流水 灯 程 序 的 汰 


玉 
如 
泡 


Q の 第 四 过 の の 
模拟 比较 器 (COMP) 


模拟 比较 融 是 一 个 比较 两 个 模拟 电压 大 小 的 外 设 ， 并 提供 一 个 逻辑 输出 信号 作为 比较 的 
结果 。 比 较 吉 可 以 向 器 件 引 脚 提 供 输 出 ， 以 替代 板 上 的 模拟 比较 器 。 它 也 可 以 通过 中 晰 或 触 
发 向 应 用 发 出 启动 ADC 转换 的 信号 。 中 断 产生 人 逻辑 和 ADC 触发 是 各 自 独立 的 。 也 就 是 说 ， 
即使 中 断 在 上 升 沿 产生 ,ADC 也 可 在 下 降 沿 触发 。 

比较 器 的 API 提供 了 一 组 用 于 编程 和 使 用 模拟 比较 器 的 函数 。 此 驱动 程序 包含 在 driver- 
lib/comp. c 中 , driverlib/comp. h 包含 API 函数 的 定 叉 。 


本 章 的 主要 内 容 : 


> COMP 单元 
> COMP 固件 库 函 数 (请 见 书后 附录 DD) 
> 例 程 
































COMP 特 点 








TM4C123GH6PM 微 控 制 器 提供 两 个 独立 集成 的 模拟 比较 器 。 它 们 具有 如 下 特点 : 
1) 可 以 比较 外 部 输入 引 脚 与 外 部 输入 引 脚 或 内 部 可 编程 的 参考 电压 。 

2) 比较 器 可 执行 测试 电压 与 下 列 电压 的 比较 : 

① 单个 外 部 独立 的 参考 电压 。 

② 共享 单个 外 部 参考 电压 。 

③ 共享 内 部 参考 电压 。 


COMP 模块 框图 
COMP 模块 框图 如 图 6-1 所 示 。 
信号 描述 


COMP 信和 号 描述 见 表 6-1。 
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C2— 
C2+ 


C1- 
Cl+ 


C0- 
CO+ 


内 部 
总 线 


-ve 输入 


入 
入 





比较 器 2 


比较 器 1 


ve 输入 (可 选 ) 


参考 输入 


TL2 
AT2 





ACMPPP 


較 6-1 


COMP 模块 相 




















[HL 
| 





注意 : TM4C123CH6PM 微 控 制 器 只 有 两 个 模拟 比较 器 。 
表 6-1 COMP 信号 (64LOFP) 






























































引 胸 名 称 | 引 肢 编号 ん | 引 县 类 型 | oo 描述 
CO+ 14 PC6 I 模拟 模拟 比较 器 0 同 相 输 入 
CO - 13 PC7 1 模拟 模拟 比较 器 0 反 相 输入 
COo 28 PFO(9) 0 TTL 模拟 比较 需 0 输出 
Cl+ 15 PC5 1 模拟 模拟 比较 器 1 同 相 输入 
C1 - 16 PC4 1 模拟 模拟 比较 器 1 反 相 输入 
Clo 29 PF1(9) 0 TTL 模拟 比较 带 1 输出 
功能 简介 


比较 器 比较 VIN - 和 VIN+ 的 输入 ， 


VIN - <VIN + , VOUT =1 
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然后 输出 VOUT。 


VIN - >VIN +,VOUT =0 

VIN - 的 信号 源 是 一 个 外 部 输入 ( Cn - ) 其 中 n 为 模拟 比较 器 的 编号 。 除 了 外 部 的 输 
入 源 ( Cn+ ) 之 外 , VIN + 的 输入 源 还 可 为 C0 + ， 或 为 一 个 内 部 参考 电压 〈(Vwm ) ， 如 
图 6-2 所 示 。 


-ve 输入 
+ve 箱 人 


ュー ニャ ーー 


+ve 输 入 〈 可 选 ) 






参考 输入 


mm 
ACSTAT 


内 部 总 线 中 断 
图 6-2 ”比较 单元 的 结构 








比较 器 是 通过 两 个 状态 /控制 寄存 器 〈 即 模拟 比较 器 控制 寄存 器 (ACCTL) 和 模拟 比较 
器 状态 寄存 絮 (ACSTAT) ) 来 配置 的 。 而 内 部 参考 电压 则 是 通过 一 个 控制 寄存 器 〈 即 模拟 
比较 器 参考 电压 控制 寄存 器 (ACREFCTL) ) 来 配置 的 。 中 断 的 状态 和 控制 则 需 通过 三 个 寄 
存 器 〈 即 模拟 比较 器 中 断 状态 寄存 器 (ACMIS ) 、 模 拟 比较 原始 中 断 状态 寄存 器 CACRIS) 
和 模拟 比较 器 中 断 使 能 寄存 器 (ACINTEN) ) 来 配置 。 

一 般 情 况 下 ， 比 较 器 的 输出 通过 ACCTL 寄存 器 中 的 ISEN 位 在 内 部 产生 一 个 中 断 ， 此 
输出 也 可 以 用 于 驱动 外 部 引 脚 ( Cno ) 或 产生 模 数 转换 器 (ADC) 触发 信号 。 

注意 : 在 使 用 模拟 比较 器 之 前 ，ACCTL 寄存 器 中 的 ASRCP 位 必须 置 位 。 

内 部 参考 电压 由 单一 配置 寄存 器 ACREFCTL 控制 ， 其 结构 如 图 6-3 所 示 。 











VDDA NxR 











RNG 


图 6-3 ”比较 器 内 部 参考 电压 结构 





可 根据 ACREFCTL 寄存 器 中 的 RNG 位 ， 采 用 两 种 模式 ( 低 电 平 或 高 电 平 ) 来 编程 内 部 
参考 电压 。 当 RNG 位 清 零 时 ， 内 部 参考 电压 采用 高 电 平 模式 ; 当 RNG 位 置 位 时 ， 则 内 部 参 
考 电压 采用 低 电 平 模式 。 

在 每 种 模式 下 ， 内 部 参考 电压 (Vi ) 有 16 级 预 编程 阔 值 或 步 长 。 用 于 与 外 部 输入 电 
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压 比 较 的 阔 值 电压 ， 可 使 用 ACREFCTL 寄存 器 中 的 VREF 字段 来 选择 。 内 部 参考 电压 与 
ACREFCTL 字段 值 见 表 6-2。 





表 6-2 内 部 参考 电压 与 ACREFCTL 字段 值 


ACREFCTL 寄存 器 





基于 VREF 字段 值 的 输出 参考 电压 








EN 位 值 | RNG 位 值 





EN=0 | RNG=X | VREF 的 值 为 0V(GND); 建议 使 用 RNG =1 和 VREF =0 来 获得 低 噪声 的 接地 参考 























rmgr 高 回 平 , 16 级 阔 值 电压 VREF =0、1、2 、…、15 

想 的 起 始 电压 (VREF =0) : VDDA /4.2 

想 的 步 长 : VDDA/ 29. 4 

E 想 的 Viner 国 值 : Viner (VREF) =VDDA/4.2+ VREF * (VDDA/ 29.4， 其 中 VREF =0、 
1、2 、…、15 




















RNG =0 


并 并 并 过 




















EN=1 
Vsr 低 电 平 : 16 级 阔 值 电压 VREF =0、1、2 、…、15 
理想 的 起 始 电压 (VREF =0) : 0V 
到 
到 





RNG =1 里 想 的 步 长 : VDDA/ 22. 12 
里 想 的 Vi 闽 值 :， Ver (VREF) =VREF * (VDDA/ 22.12), 其 中 VREF =0、1、2 、 


…、15 


























寄存 器 映射 
表 6-3 中 列 出 了 模拟 比较 器 的 寄存 器 映射 ， 表 中 所 列 偏 移 量 是 寄存 器 地 址 相对 于 模拟 
比较 需 基 址 (0x4003. C000) 的 増量 (十 六 进 制 地 址 ) 。 注 意 ， 在 对 这 些 寄存 器 编程 之 前 必 
须 先 行使 能 模拟 比较 器 的 时 钟 ， 且 在 该 时 钟 使 能 后 ， 必 须 等 待 至 少 3 个 系统 时 钟 才 可 访问 
模拟 比较 器 寄存 器 。 
表 6-3 ”模拟 比较 器 寄存 器 映射 


















































局 移 量 | 名 称 | 类 型 复 位 描 述 
0x000 ACMIS R/WIC 0x0000. 0000 模拟 比较 器 屏蔽 中 断 状 态 寄 存 器 
0x004 ACRIS RO 0x0000. 0000 模拟 比较 器 原始 中 断 状态 寄存 器 
0x008 ACINTEN R/W 0x0000.0000 模拟 比较 器 中 断 启用 寄存 器 
0x010 ACREFCTL R/W Ox0000.0000 模拟 比较 器 参考 电压 控制 寄存 器 
0x020 ACSTATO RO 0x0000. 0000 模拟 比较 器 状态 寄存 器 0 
0x024 ACCTLO R/W Ox0000.0000 模拟 比较 器 控制 寄存 器 0 
0x040 ACSTATI RO 0x0000. 0000 模拟 比较 器 状态 寄存 器 1 
0x044 ACCTLI R/W Ox0000.0000 模拟 比较 器 控制 寄存 器 1 
OxFCO ACMPPP RO Ox0003.0003 模拟 比较 器 外 设 属性 寄存 器 


























比较 器 的 API 就 像 比较 需 本 身 一 样 简单 ， 主 要 由 两 组 困 数 组 成 
QD 配置 比较 器 和 读 取 输 出 函数 。 
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② 比较 器 中 断 处 理 函 数 。 
(1) 配置 比较 右 和 读 取 输出 函数 
e ComparatorConfigure( ) 。 

e ComparatorRefSet( ) 。 

e ComparatorValueGet( ) 。 
(2) 比较 器 中 断 处 理 函 数 

e ComparatorIntRegister( ) 。 

® ComparatorIntUnregister( ) 。 
e ComparatorIntEnable( ) 。 

e ComparatorIntDisable( ) 。 

e ComparatorIntStatus( ) 。 


e ComparatorIntClear( ) 。 


详细 的 模拟 比较 器 固件 库 函 数 功能 说 明 请 参考 书后 附录 D。 


$ss 例 程 


本 小 节 两 个 示例 介绍 模拟 比较 器 的 编程 与 调试 方法 。 

1. 同 相 输入 端的 参考 电压 为 内 部 参考 电压 (在 Proteus 中 测试 ) 
(1) 比较 器 的 硬件 接线 图 

硬件 接线 图 如 图 6-4 所 示 。 










接 比较 器 
的 输出 端 


指示 比较 
器 状态 


接 比较 器 的 
反 相 输入 端 






10nF 





器 


图 6-4 程序 硬件 接线 














(2) 编写 比较 器 程序 
ホホ ホネ ポ ホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ 
//! 程 序 名 :comparator. C 
//! 来 源 : 根据 TL 例 程 改编 
/A1! 程 序 功能 说 明 : 模 拟 比较 器 的 操作 方法 
/A! 即 在 比较 器 0 的 反 相 输入 端 接 一 个 电位 器 作为 外 部 输入 电压 源 与 内 部 产生 的 1. 7875V 
// 1 参考 电压 进行 比较 ,并 根据 其 输出 改变 中 断 来 翻转 端口 B0 上 LED 的 状态 。 当 检测 到 
/A1 比 较 器 输出 的 上 升 沿 时 ,中 断 服务 程序 点 亮 LED , 而 检测 到 比较 器 的 下 降 沿 时 中 断 服务 
//1! 程 序 熄 灭 LED 
//! 比较 器 原理 : VIN - <VIN+,VOUT=1 
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//! VIN - >VIN+ ,VOUT=0 
//1 调试 思想 : 

//! 上 升 沿 :VIN- >VIN+ 一 VIN- <VIN+ , 即 0 一 11† 
ノノ ! 下降 沿 :VIN- <VIN+ 一 VIN- >VIN+ , 即 1 一 0 1 


// ネネ ネネ ネネ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ネ ボ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ネネ ポポ ポポ 

















#include "inc/hw_ints. h" 
#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/comp. h" 
#include " driverlib/debug. h" 
#include " driverlib/gpio. h" 
#include " driverlib/interrupt. h" 
#include " driverlib/sysctl. h" 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ボボ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 
3 = ヽ 口 、 Ne) 

// 如 果 驱 动 程序 库 发 生 错 误 ,将 调用 该 错误 例 程 

// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 

#ifdef DEBUG 


void 




















error_ (char * pcFilename ,unsigned long ulLine ) 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ 


/7 比较 器 中 断 处 理 程序 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 





void 
CompIntHandler( void ) 
| 
KS 
/清除 比较 器 中 断 
ZN 
ComparatorIntClear( COMP_BASE,0) ; 











/ 
// 根 据 比 较 器 当前 的 输出 值 来 设置 CPIO BO 口 的 值 
// 


if( ComparatorValueGet( COMP_BASE ,0) == true) 


| 
GPIOPinWrite( GPIO_PORTB_BASE, GPIO_PIN_0, GPIO_PIN._0); 





GPIOPinWrite( CPIO_PORTB_BASE,CPIO_PIN_0.0): 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ボネ ボボ ポポ ポポ ボネ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ 
// 这 个 例子 演示 了 如 何 设置 一 个 模拟 比较 融 以 及 触发 输出 变化 中 断 


// ネネ ボネ ネネ ポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 








ゴゴ 


int 

main( void ) 

| 
// 
// 设 置 直接 从 晶振 运行 的 时 外 
// 
SysCtIClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_O0SC_MAIN | 

SYSCTL_XTAL_6MHZ) ; 


= 








// 

// 使 能 要 用 到 的 外 设 

// 

SysCLPeripheralEnable( SYSCTL_PERIPH_COMPO ) ; 
SysCLPeripheralEnable( SYSCTL_PERIPH_CPIOB) ; 

// 

// 使 能 处 理 器 中 断 

// 

IntMasterEnable( ) ; 

// 

/设置 GPIO BO 为 输出 ,在 此 端口 外 接 一 只 LED 以 指示 当前 比较 噩 的 输出 值 
// 
GPIOPinTypeGPIOOutput(GPIO_PORTB_BASE,GPIO_PIN_0): 




















// 
// 配 置 反 相 输 出 端 ( C0 - ) 
// 


GPIOPinTypeComparator( GPIO_PORTB_BASE,GPIO_PIN 4) ; 





// 
// 设 置 内 部 参考 电压 为 1.7875 V 
// 


ComparatorRefSet( COMP_BASE, COMP_REF_1_7875V); 


// 

// 配 置 比 较 器 使 用 内 部 参考 电压 和 在 输出 的 上 升 沿 和 下 降 沿 产生 中 断 

// 

ComparatorConfigure( COMP_BASE,0.COMP_INT_BOTH | COMP_ASRCP_REF ) ; 








// 

// 使 能 比较 器 中 断 

// 

IntEnable( INT_COMPO ) ; 
ComparatorIntEnable( COMP_BASE,0) ; 





// 
705 


706 


// 无 限 循环 用 于 LED 跟踪 比较 器 的 输出 状态 
// 
while(1 ) 
| 
| 
| 


(3) 在 CCS6 中 创建 comparator 工程 
创建 的 comparator 工程 如 图 6-5 所 示 。 
详细 的 操作 过 程 请 参考 第 1 章 有 关 CCS 6 的 使 用 方法 部 分 。 





看 = 
RE CCS Edit - comparator/comparator.c - Code Composer Studio 





File Edit View Navigate Project Run Scripts Window Help 
















































































b [人 & startup_ccs.c 








6-5 


创建 的 comparator 工程 


(4) 编译 comparator 工程 
① 指定 头 文件 和 库 文件 的 搜索 路 径 ， 如 图 6-6 所 示 。 


ーーーーー 





Nr Properties for comparato 


rE > 園 や る > r 

访 Project Explorer 品 | 日生 @) TI Resource Explorer |e 

Active - Debug] | /1 参考 电压 进行 比较 ， 并 根 : 
-Includes /71 出 的 上 升 沿 时 ， 中 断 服务 所 


Pa i ct i i i EE i tI t i bt a 










» Debug //! 比较 器 原理 : VI 
b 区 drivers 7/! A A 
bp [高 comparator_ccs.cmd A 调试 思想 上 弁 油 。 Vil 
』 7 ィ ロ 日 
cnr /1! 下 降 沿 ，VI 















> Resource 
General 








4 Build や 


Configuratig 


包含 文件 的 


-| | Manage Configura 








ARM Compiler 


ー ーー = 
Processor Options 









搜索 路 径 





Optimization 


dnclude Options) 





時 間 











『${ORIGINAL_PROJECT_ROOT/./…" | 
『5(SW_ROOTI" 












き 














4 Build 水 
> ARM 更 ompiler 


ARM Linker 










Ba 9 






File Search Path 
> Advance 















库 文件 搜 
索 路 径 





"${CG_TOOL_ROOT}/lib" 











6-6 头 文件 和 库 文 件 的 搜索 路 径 


『Add <dir> to library search path (--search_path, -| 
『$ICG_TOOL_ROOTj/include" 





② 将 CCS6 编译 产生 的 可 执行 文件 改 为 . elf 格式 ， 如 图 6-7 所 示 。 
@ 编译 comparator 工程 ， 生 成 . ef 格式 的 可 执行 文件 ， 如 图 6-8 所 示 。 





r 






























gr Properties for comparator 
type filter text Basic Options 
> Resource 
General 
2 Build Configuration: |pebug [ Active ] ~| Manag 
> ARM Compiler 
4IARM Linker 
Basic Options| 一 ンコ Specify output file name (--output_file, -O) 
File Search Path 
"| En Input and output secpongikisted into <file 








vance 0 














图 6-7 ”将 编译 生成 的 可 执行 文件 改 为 .elf 格式 

















EE Console 到 岂 他 图 | 下 四 店 直 目 ~ 对 ”二 日 | 区 problems | 9 Advice| 了 日 
ICDT Build Console [comparator] Oitems 
<Linking> Ee “| Description 


"Finished building target: comparator_-e1f* 


"C:/ti/ccsv5/utils/tiobj2bin/tiobj2bin.bat" Qcomparator.elf" 
"comparator.bin" 
































"C:/t1/ccsv5/too]1s/comp1ler/arm_5.1.1/bin/ofd479.exe" 0 个 错误 和 0 个 警告 
"C:/t1/ccsv5/too1s/compiler/arm_ 5.1.1/bin/hex470.exe” \ 
"C:/ti/ccsv5/utils/tiobj2bin/mkhex4bin.exe" Wu 

y \ 由 

ye” Bu11d F1n1shed ポポ ポポ 编译 生成 的 .elf 格 式 文件 国 | 

| "| E 











图 6-8 工程 编译 结果 生成 . elf 格式 文件 


($) 在 Proteus 8. 1 中 对 工程 的 编译 结果 进行 测试 
① 搭建 虚拟 测试 电路 ， 如 图 6-9 所 示 。 


PAO/UORX PDO/PWMO 
PATU0TX PD1PWM1 
PA2SSICLK PD2 
PA3/SSIFSS PD3 
PA4SSIRX PD4 
PA57SSITX PD57CCP2 
PB0/CCP0 PD67FAULT 
PB1 PD7/C0o 
PB2 PE0 
PB3 PE1 
PB4/C0- 

PB5/C1- ADC0 
PB6/CO+ ADC1 
PB7/TRST ADC2 
PCO/TCKSWCLK ADC3 
PC17TMS/SWDIO 

PC2/TDI 

PC3/TDO/SWO 

PC4 

PC5/C1+/C1o 

PC6 

PC7 


LM3S301 








图 6-9 ”比较 器 程序 的 虚拟 测试 电路 


Q 导入 编译 产生 的 . et 文件 到 测试 电路 中 ， 再 将 电位 器 中 心 触 点 移 到 最 上 面 ， 然 后 局 
动 Proteus 测试 ， 这 时 比较 带 的 输出 为 0， 如 图 6-10 所 示 。 

















107 





§ comparator - Proteus 8 Professional (BETA) - Schematic Capture 





File | Edit View Tool Design Graph Debug Library Template System Help 
唱 上 回 地主 較 画 角 魚 デ EE きこ 
向 Home Page ※ Sd LED 熄 灭 





jp &|% 昌 龟 | 加 加 国 略 | 人 & 半 部 












图 Design Explorer ※ 











U1 
里 SS FE ls] PAOIUORX PDDPWM0 に 
PA1UUOTX PD1PWM1 









テー PA2/SSICLK PD2 
2 | PA3ISSIFSS PD3 
| PA4/SSIRX PD4 
29m | PASISSITX PD5/CCP2 
上 PBQ/CCP0 PD6/FAULT 


30W 
i PD7/C0o 














反 相 输入 电压 为 2.97V 
即 , VIN->VIN+, VOUT=0 








FP 心 触 点 移 到 最 上 端 


は | 鹿 OQ キキ 画 と @ ワ ⑧ 男 ヽ 下 





LM3S301 

















rh 上 | NM 4Messagels] : ANIMATING: 00:00:08.960962 (CPU load 82%) 














器 





6-10 模拟 比较 器 的 输出 为 0 





为 了 能 模拟 一 个 上 升 沿 ， 应 该 让 比较 融 的 输出 为 1， 即 VIN - <VIN + ,VOUT =1， 此 时 
需 将 电位 器 的 中 心 触 点 往 下 移 , 使 VIN - <VIN + 。 一 旦 比较 器 输出 高 电 平 ， 将 形成 一 个 上 
升 沿 〈 即 0 一 1) ， 从 而 触发 中 断 点 亮 LED， 如 图 6-11 所 示 。 


PA0/UORX PD0/PWM0 
PA1JUOTX PD1PWM1 
PA2/SSICLK PD2 
PA3/SSIFSS 


参考 电压 VIN+=1.7875V 
测试 电压 VIN 一 1.44V 

则 VIN-<VIN+, VOUT=1 
其 过 程 为 0 一 1 形成 上 升 沿 























此 时 触发 中 断 点 亮 LED 





LM3S301 





图 6-11 模拟 上 升 沿 触发 中 断 点 亮 LED 
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接着 再 把 电位 器 中 心 触 点 往 上 移 使 VIN - > VIN + ， 即 模拟 比较 器 输出 0 ( 即 1 一 0) ， 
形成 下 降 沿 ， 其 测试 结果 如 图 6-12 所 示 。 


U1 


PAOIUORX PDO/IPWMO 
PA1IUOTX PD1/PWM1 
PA2/SSICLK FD2 
PA3/SSIFSS PD3 
PA4ISSIRX PD4 
PA5/SSITX PD5/CCP2 
PBOICCPO PD6/FAULT 
PD7/CO0 

PE0 


VIN->VIN+, VOUT=0 
即 输出 从 1 一 0 的 变化 形成 一 个 
下 降 沿 触发 中 断 熄灭 LED 





LM3S301 





图 6-12 模拟 下 降 沿 熄灭 LED 灯 


从 以 上 的 测试 结果 来 看 ， 比 较 器 程序 实现 了 所 要 求 的 功能 ， 程 序 设 计 正 确 。 
2. 在 EK - TM4C123GXL 板 上 对 程序 进行 调试 

这 部 分 仅 给 出 程序 ， 测 试 实验 请 读者 按照 上 例 自 行 完 成 。 

(1) 比较 器 例 程 连 线 图 
比较 器 例 程 连 线 图 如 图 6-13 所 示 。 


Ul TM4C123G CODD VCC 














/| 


6-13 ”比较 器 例 程 连 线 











(2) 编写 comp.c 程序 


ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギ : 
// 文 件 名 :comp. c 
// 来 源 : 实验 室 改编 
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770 


/A1 功 能 描述 : 

AA! 由 比较 右 1 负 输 入 端 输入 模拟 电压 信号 (GPIOC4) ,该 信号 与 内 部 基准 电压 1.753125V 相 比 
/A1 较 。 如 果 比 较 器 1 输出 端 产 生 上 升 沿 或 下 降 沿 ,就 触发 中 断 处 理 程序 。 中 断 处 理 程序 中 ,如 
//! 果 判断 比较 器 1 输出 端 为 1, 则 点 亮 接 在 GPIOF2 的 LED; 如 果 比 较 器 1 输出 端 为 0, 则 熄灭 
//!GPIOF2 的 LED 

//! 便 件 接 日 : 
//!EK - TM4C123GXL,PC4 接 电 位 器 产生 输入 电压 。 一 旦 电压 低 于 1.753125V, 则 LED 蓝 灯 亮 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ 




































































#include < stdint. h > 

#include < stdbool. h > 

#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include "inc/tm4c123gh6pm. hy" 
#include " driverlib/comp. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/ gpio. h" 
#include " driverlib/interrupt. h" 


ンク キキ キキ キキ キキ キキ キキ キキ キキ テキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ 
二 As 日 hg 

// 声 明 比 较 器 1 中 断 处 理 程序 

ンク キキ キキ キキ キキ キ キキ キキ キキ キキ テキ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ : 

void CompIntHandler( void ) ; 

ンク キキ キキ キキ キキ キキ キキ キキ キキ テキ テテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ 

本 i 和 8 

// 如 果 驱 动 程序 库 发 生 错误 ,将 调用 该 错误 例 程 

ンク キキ キキ キキ キキ キキ キキ キキ キキ テキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ キテ そそ : 

#ifdef DEBUG 


void 


























_ error_ (char * pcFilename ,unsigned long ulLine) 

#endif 

ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギ : 
// 比 较 器 1 中 断 处 理 程序 


// ネネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 








void 
CompIntHandler( void ) 
| 
bool Comp_out; 
ノ / 
/清除 比较 器 1 中 断 标志 
ノ / 
ComparatorIntClear( COMP_BASE,1 ) : 
ノ / 
/根据 比较 融 1 输出 值 来 设置 GPIOF2 的 值 
//tm4c123gxl 板子 上 ,CPIOF2 接 LED_BLUE,CPIOF2 位 高 电 平时 ,LED 蓝 灯 亮 
// 
Comp_out = ComparatorValueGet( COMP_BASE ,1 ) ; 
if(Comp_out ==1 ) 





GPIOPinWrite( CPIO_PORTF_BASE,CPIO_PIN_2.,0x04) ; 


GPIOPinWrite( CPIO_PORTF_BASE,CPIO_PIN_2.0x00) : 


int main( void ) 
| 

SysCtlClockSet (SYSCTL_SYSDIV_10 | SYSCTL_USE_PLL | SYSCTL_0SC_MAIN | SYSCTL_ 
XTAL_16MHZ) ; 

// 

// 使 能 比较 器 模块 

// 注 意 : 无 论 是 比较 器 0 还 是 比较 器 1 ,使 能 函数 中 的 参数 都 必须 是 SYSCTL_PERIPH_COMP0 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_COMPO ) ; 

// 

// 配 置 比 较 器 1 

// 比 较 器 不 触发 ADC, 比较 器 输出 端的 上 升 沿 和 下 降 沿 都 将 产生 中 断 

// 比 较 器 1 正 输入 端 采 用 内 部 基准 电压 ; 比较 器 1 输出 端 信号 正常 输出 (不 翻转 ) 

// 

ComparatorConfigure( COMP_BASE ,1,COMP_TRIG_NONE | COMP_INT_BOTH | COMP_ASRCP_ 
REF | COMP_OUTPUT_NORMAL ) ; 

// 

// 设 置 比较 右 内 部 基准 电压 值 为 1.753125V 

// 

ComparatorRefSet( COMP_BASE, COMP_REF_1_753125V); 

ZZ 

// 使 能 GPIOF 和 CPIOC 模块 ,GPIOF2 作为 LED 灯 的 输出 ;GPIOC4 为 比较 器 1 的 负 输 入 端 

// 注 意 : 如 果 片 上 外 设 用 到 GPIO 端口 ,必须 使 能 相应 的 GPIO 模块 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOF) ; 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOC) ; 

// 

// 将 GPIOF2 设置 为 输出 模式 

// 

CPIOPinTypeCPIOOutput(CPIO_PORTF_BASE,CPIO_PIN_2), 

// 

// 将 GPIOC4 设置 为 比较 器 1 的 负 输 入 端 

// 

GPIOPinTypeComparator( GPIO_PORTC_BASE,GPIO_PIN_4 ) ; 

// 

// 使 能 比较 器 1 的 

// 

ComparatorIntEnable(COMP_BASE ,1) ; 

// 
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/注册 比较 器 1 的 中 断 处 理 程序 

// 

ComparatorIntRegister( COMP_BASE ,1 ,CompIntHandler) : 
// 

// 使 能 全 局 中 断 

// 

IntMasterEnable( ) ; 








// 
// 进 入 无 限 循环 
// 
while( 1); 
| 
(3) 建立 工程 及 调试 步骤 
将 上 述 程序 下 载 到 EK - TM4C123GXL 板 中 ， 按 运行 按钮 ， 然 后 调节 与 PC4 引 脚 所 连接 
的 电位 器 ， 使 输入 电压 信和 号 发 生 改 变 ， 可 观察 LaunchPad 板 上 蓝 色 LED 灯 的 亮 灭 ， 如 
图 6-14a、b 所 示 。 


ey 


J 
NM 


二 了 





图 6-14 蓝 色 LED 灯 的 亮 火 
a) LED 蓝 灯 亮 b) LED 蓝 灯 灭 
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ao 第 / き の の 
系统 定时 与 中 断 控 制 


学 习 本 章 内 容 前 ， 先 介绍 一 下 系统 定时 器 和 中 断 控制 右 。 

(1) 系统 定时 器 (SysTick) 

TM4C123GH6PM 控制 器 内 核 集成 了 一 个 系统 定时 右 (SysTick ) ， 它 是 一 个 简单 的 定时 
器 ， 为 Cortex - M 微 处 理 器 NVIC 控制 器 中 的 一 部 分 ， 其 作用 是 为 RTOS 提供 一 个 周期 性 中 
斯 。 另 外 它 也 可 用 于 其 他 简单 的 定时 操作 ， 提 供 一 个 简单 的 、 控 制 灵 活 的 24 位 递减 计数 
器 ， 还 具有 写 入 即 清 零 、 过 零 自 动 重 载 等 特性 。 在 调用 SysTick 中 断 处 理 程 序 时 ， 会 通过 
NVIC 自动 清除 SysTick 的 中 断 源 。 

1) 系统 定时 器 的 应 用 如 下 : 

① 作为 RTOS 的 节拍 定时 器 ， 可 按 编程 频率 定时 和 触发， 调用 系统 定时 器 处 理子 程序 。 

② 可 作为 使 用 系统 时 钟 的 高 速 报警 定时 器 。 

@) 速率 可 变 的 报警 或 信号 定时 器 。 

④ 可 作为 简易 计数 器 ， 用 于 测量 任务 的 完成 时 刻 、 总 体 耗 时 等 。 

⑤ 可 实现 依据 失 配 /匹配 周期 的 内 部 时 钟 源 控制 。 

2) 系统 定时 器 所 包含 的 3 條 寄 存 器 如 下 : 

① 控制 和 状态 (STCTRL) : 控制 和 状态 计数 器 用 于 配置 时 钟 、 使 能 计数 器 、 使 能 中 断 
与 确定 计数 器 的 状态 。 

② 重 载 值 (STRELOAD) : 计数 絮 的 重 载 ， 用 于 计数 器 的 重 装 值 (Wrap Value ) 。 

③ 当前 值 (STCURRENT) : 计数 器 的 当前 值 。 

3) 工作 过 程 描述 如 下 . 

在 使 能 系统 定时 器 后 ， 计 数 器 对 于 每 个 时 钟 将 递减 一 次 ， 从 重 载 值 依次 递减 到 0， 然后 
在 下 一 个 时 钟 沿 翻转 ， 再 对 每 个 时 钟 递减 一 次 ， 周 而 复 始 。 如 果 将 STRELOAD 寄存 器 清 零 ， 
将 在 下 次 重 载 时 禁止 该 计数 器 。 当 计数 器 递减 到 0 时 ，COUNT 标志 位 将 被 置 位 。 读 取 
COUNT 标志 位 后 将 使 其 自动 清 零 。 

若 写 STCURRENT 寄存 器 ， 可 将 其 清 零 ， 并 且 还 可 清除 COUNT 标志 位 。 写 该 寄存 器 时 
不 会 触发 SysTick 异常 逻辑 ， 而 读 取 该 寄存 凯 时 ， 其 返回 值 是 此 寄存 右 被 访问 时 刻 的 内 容 。 

SysTick 计数 器 按照 系统 时 钟 或 精确 内 部 振荡 器 (PIOSC) 4 分 频 运 行 。 若 在 某 些 低 功 耗 
模式 下 停止 供给 该 时 钟 信号 ， 将 会 使 系统 定时 器 上 的 计数 器 也 会 停止 运行 。 在 SysTick 控制 
和 状态 寄存 器 (STCTRL) 中 置 位 CLK_SRC 位 ， 并 保证 深度 睡眠 时 钟 配置 寄存 器 (DSLP- 
CLKCFG) 中 的 PIOSCPD 位 被 清 零 ， 以 便 SysTick 在 深度 休眠 模式 中 保持 运行 状态 。 在 软件 
访问 SysTick 的 寄存 器 时 ， 应 保证 始终 采用 字 对 齐 操作 访问 。 

4) 复位 后 的 操作 。 在 复位 时 ， 由 于 SysTick 计数 器 的 重 载 值 和 当前 值 未 被 定义 ， 则 Sy- 
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sTick 计数 器 的 正确 初始 化 过 程 如 下 : 

① 编程 STRELOAD 寄存 器 中 的 值 。 

② 写 人 任意 值 到 STCURRENT 寄存 器 中 使 其 清 零 。 

③ 将 STCTRL 寄存 器 配置 成 所 要 求 的 操作 。 

注意 : 在 调试 时 ， 若 处 理 吉 暂停， 该 计数 需 将 不 会 递减 。 

此 驱动 程序 包含 在 driverlib/systick. c 中 ，driverlib/systick. h 包含 应 用 程序 使 用 的 API 的 
定义 。 

(2) 敬三 式 向 量化 中 断 控 制 益 (NVIC) 

中 断 为 CPU 实时 地 处 理 内 部 或 外 部 事件 的 一 种 机 制 。 当 发 生 某 种 事件 时 ，CPU 将 暂停 
当前 的 程序 执行 ， 转 而 去 处 理 中 断 事件 。 当 中 断 服务 程序 结束 后 ， 又 会 返回 到 前 面 程序 的 中 
断 处 ， 重 新 开始 往 下 执行 。 

TM4C123GH6PM 控制 器 包含 ARM 瞬 套 向 量 中 断 控制 需 (Nested Vectored Interrupt Con- 
troller, NVIC) 。NVIC 和 TM4C 处 理 器 在 处 理 模式 中 可 对 所 有 异常 进行 优先 级 划分 和 处 理 。 
且 在 处 理 异常 时 处 理 器 状态 将 会 自动 保存 到 堆栈 中 ， 而 当中 断 服务 程序 (ISR) 结束 时 又 会 
日 动 恢复 。 中 断 癌 量 的 读 取 与 状态 保存 同步 ， 可 高 效 地 进入 中 断 。 处 理 带 支持 尾 链 技术 ， 背 
对 背 的 中 断 执行 可 免 去 入 栈 和 出 栈 的 时 间 开 销 。 并 可 软件 设置 7 个 异常 (系统 处 理 妖 ) 和 
78 个 中 断 的 8 级 优先 级 。 

中 断 处 理 程序 的 配置 方式 : 在 编译 时 静态 配置 ， 在 运行 时 动态 配置 。 

静态 配置 可 通过 编辑 使 能 代码 中 的 中 断 程序 表 来 实现 。 在 静态 配置 时 ， 必 须 首 先 通 过 使 
能 IntEnable ( ) 函数 才能 开启 NVIC 中 断 ， 处 理 需 才 可 响应 该 中 断 。 

对 于 中 断 在 运行 时 的 动态 配置 ， 可 使 用 IntRegister( ) 或 相关 驱动 函数 进行 。 当 使 用 In- 
tRegister( ) 时， 首先 必须 使 能 中 断 ; 当 使用 単 介 相 共 頁 数 時 , IntEnable( ) 由 驱动 函数 调用 ， 
而 无 需 由 程序 来 调用 。 

中 断 控 制 API 提供 了 一 组 处 理 NVIC 的 函数 。 该 函数 用 于 使 能 和 禁止 中 断 、 注 册 中 断 
处 理 程序 和 设置 中 断 优先 级 。 

此 驱动 程序 包含 在 driverlib/ interrupt. c 中 , driverlib/interrupt h 包含 应 用 程序 使 用 的 API 
的 定义 。 

本 章 主要 内 容 : 

> 中 断 控制 器 

> 系统 定时 需 

> 中 断 及 系统 定时 融 固 件 库 函数 ( 见 附录 下) 











> 系统 定时 器 中 断 实例 
4 7.1 NVIC 模块 
NVIC 模块 的 特点 
NVIC 模块 支持 的 一 些 主要 特点 如 下 : 
① 78 个 中 断 。 
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② 每 个 中 断 分 为 0 ~7 个 优先 级 均 可 编程 ，0 为 最 高 优先 级 。 

③ 低 延 时 异常 和 中 断 处 理 。 

④ 中 断 信 号 的 电 平 检测 和 脉冲 检测 。 

⑤ 动态 重新 分 配 中 断 的 优先 级 。 

@) 分 组 的 优先 级 ， 被 划分 为 组 优先 级 字段 和 子 优先 级 字段 。 

⑦ 支持 背靠背 的 中 断 尾 链 技术 。 

⑧ 提供 一 个 外 部 不 可 屏蔽 中 断 (NMI) 。 

功能 描述 

1. 电 平 式 与 脉冲 式 中 断 

处 理 器 支持 电 平 式 中 断 及 脉冲 式 中 断 。 脉 冲 式 中 断 通 常 又 称 为 边沿 触发 中 断 。 

对 于 电 平 式 中 断 而 言 ， 只 要 外 设 产生 中 断 信 号 就 会 始终 保持 处 于 触发 状态 ， 直 到 外 设 中 
断 信 号 复原 后 才 不 再 触发 。 一 般 来 说 ， 这 需要 ISR (中 断 服务 子 程序 ) 对 外 设 进行 操作 ， 使 
得 外 设 不 再 产生 中 断 请 求 信 和 号。 脉冲 中 断 是 在 处 理 器 时 钟 的 上 升 沿 同步 采样 的 中 断 信号 。 为 
了 确保 NVIC 能 够 检测 到 中 断 ， 外 设 所 产生 的 中 断 信号 必须 保持 至 少 一 个 时 钟 周期 ， 在 此 期 
间 NVIC 可 检测 到 脉冲 并 锁 存 中 断 。 

处 理 器 进入 ISR 后 ， 将 自动 清除 该 中 断 的 挂 起 状态 。 对 于 电 平 式 中 断 ， 如 果 处 理 器 从 
ISR 返回 后 ， 中 断 信 和 号 仍 未 复原 ， 则 中 断 将 再 次 挂 起 ， 于 是 处 理 器 必须 再 次 运行 其 ISR。 因 
此 ， 外 设 可 以 像 这 样 保持 中 断 信号 持续 享用 服务 ， 直 到 其 不 再 需要 服务 为 止 。 

2. 中 断 的 硬件 控制 及 软件 控制 

1) Cortex - M4 锁 存 所 有 中 断 。 当 满足 以 下 其 中 一 个 条 件 时 ， 外 设 中 断 将 被 挂 起 : 

① NVIC 检测 到 中 断 信 号 为 高 电 平 ， 且 该 中 断 未 处 于 激活 状态 。 

② NVIC 检测 到 中 断 信 号 的 上 升 沿 。 

@) 软件 写 入 相应 的 中 断 设置 挂 起 寄存 器 的 位 , 或 者 写 入 软件 触发 中 断 寄 存 器 
(SWTRIG) 使 软件 产生 的 中 断 挂 起 。 

2) 中 断 挂 起 后 到 出 现 以 下 条 件 之 一 时 ， 将 一 直 保 持 挂 起 状态 : 

① 处 理 器 进入 该 中 断 的 ISR， 将 中 断 状态 由 挂 起 变更 为 激活 。 

e 对 于 电 平 中 断 ， 当 处 理 器 从 ISR 返回 后 ，NVIC 将 重新 采样 中 断 信 号 。 若 检测 到 的 中 

断 信号 有 效 ， 则 中 断 状态 将 再 次 处 于 挂 起 状态 ， 导 致 处 理 器 立即 重新 问 到 ISR: 否 
则 ， 中 断 状 态 将 变 为 未 激活 状态 。 

e 对 于 脉冲 中 断 ， 处 理 器 将 连续 监控 中 断 信 号 。 如 果 检 测 到 中 断 脉冲 信号 ， 就 会 将 中 断 
状态 变更 为 挂 起 和 激活 。 因 此 ， 当 处理 器 从 ISR 返回 后 ， 中 断 状态 将 再 次 被 挂 起 ， 导 
致 处 理 需 立即 重新 进入 ISR 。 

若 处 理 器 在 ISR 中 并 未 产生 中 断 脉冲 信号 ， 则 当 处 理 絮 从 ISR 返回 后 ， 中 断 状 态 将 变更 
为 未 激活 状态 。 

② 软件 写 入 清除 中 断 挂 起 寄存 器 中 的 相应 位 。 

e 对 于 电 平 中 断 ， 如 果 中 断 信 号 仍然 有 效 ， 则 中 断 状 态 将 保持 不 变 ; 否则 ， 中 断 状态 将 

变更 为 未 激活 状态 。 

e 对 于 脉冲 中 断 ， 如 果 状 态 为 挂 起 或 激活 ， 或 者 状态 为 激活 或 挂 起 ， 则 中 断 都 将 NVIC 
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紧密 结合 Cortex - M 微 处 理 器 。 当 处 理 器 响应 一 个 中 断 时 ，NVIC 直接 到 处 理 器 提供 
函数 的 地 址 去 处 理 中 断 。 因 此 可 以 取消 一 个 全 局 中 断 处 理 程序 ， 去 查询 中 断 控制 器 以 
确定 中 断 源 并 跳 转 到 相应 的 中 断 处 理 程序 ,减少 了 中 断 的 响应 时 间 。 


中 断 优 先 级 


NVIC 人 允许 先 处 理 优先 级 更 高 的 中 断 再 处 理 优 先 级 低 的 中 断 ， 人 允许 高 优先 级 中 断 抢占 低 优 
先 级 的 中 断 处 理 程序 。 这 有 助 于 减少 中 断 响应 时 间 。 并 且 采 用 子 优先 级 排序 ， 取 代 具 有 N 位 抢 
占 式 优先 排序 ，NVIC 可 以 通过 软件 配置 N - M 位 抢占 式 优先 级 和 M 位 的 子 优先 级 。 在 这 个 方 
案 中 ， 两 个 具有 相同 的 抢占 式 优先 级 但 不 同 的 子 优先 级 的 中 断 不 会 引起 抢占 ; 尾 链 的 使 用 使 两 
个 中 断背 靠背 的 处 理 。 如 果 两 个 具有 相同 优先 级 的 中 断 (包括 子 优先 级 也 相同 ) 同时 到 达 ， 则 
较 低 中 断 号 的 中 断 被 先行 处 理 ;， 如果 中 断 号 仍然 相同 则 排 在 中 断 向 量 表 前 面 的 中 断 先行 处 理 。 
NVIC 跟踪 骨 套 的 中 断 处 理 程 序 ， 人 允许 处 理 器 在 所 有 中 断 嵌 套 和 挂 起 的 中 断 处 理 完 成 后 返回 。 


中 断 异 常 
中 断 异 常 类 型 见 表 7-1。 








表 7-1 异常 类 型 





































































































异常 类 型 向 量 号 | 优先 级 向 量 地 址 或 偏 移 量 激 活 
0 0 0 复位 时 栈 项 从 向 量 表 的 首 人 口 
加 载 
复位 1 -3 (最 高 ) | 0x0000. 0004 异步 
不 可 屏蔽 的 中 断 (NMI) | 2 = 0x0000. 0008 异步 
硬 故 障 3 -1 0x0000. 000C 一 
存储 器 管理 4 可 编程 0x0000. 0010 同步 
总 线 故 障 5 可 编程 0x0000. 0014 精确 时 同步 ， 不 精确 时 异步 
使 用 故障 6 可 编程 0x0000. 0018 同步 
= 7~10 可 编程 一 保留 
SVCall (系统 服务 调用 ) | 11 可 编程 0x0000. 002C 同步 
调试 监视 器 12 可 编程 0x0000. 0030 同步 
= 13 可 编程 一 保留 
PendSV ( 可 挂 起 的 系统 各 和 局 
服务 请 求 ) 14 可 编程 0x0000. 0038 异步 
SysTick (系统 定时 器 ) 15 可 编程 0x0000. 003C 异步 
中 断 可 编程 16 及 其 以 上 | 可 编程 0x0000. 0040 及 其 以 上 异步 
寄存 器 映射 
NVIC 寄存 器 映射 见 表 7-2。 
表 7-2 NVIC 寄存 器 映射 
偏 移 量 名 称 | 类 型 复 描述 
Ox100 ENO R/W 0x0000.0000 中 断 0 -31 置 位 使 能 寄存 器 
Ox104 EN1 R/W 0x0000.0000 中 断 32 -63 置 位 使 能 寄存 器 




































































































































































偏 移 量 名 称 | 类 型 复 位 首 。 述 
Ox108 EN2 R/W 0x0000.0000 断 64 ~95 置 位 使 能 寄存 器 
Ox10C EN3 R/W 0x0000.0000 断 96 ~ 127 置 位 使 能 寄存 器 
Ox110 EN4 R/W 0x0000.0000 断 128 -138 置 位 使 能 寄存 
0x180 DIS0 R/W 0x0000.0000 断 0 -31 清除 使 能 寄存 器 
Ox184 DIS1 R/W 0x0000.0000 断 32 -63 清除 使 能 寄存 器 
Ox188 DIS2 R/W 0x0000.0000 断 64 ~ 95 清除 使 能 寄存 器 
Ox18C DIS3 R/W 0x0000.0000 断 96 ~ 127 清除 使 能 寄存 器 
0x190 DIS4 R/W 0x0000.0000 断 128 ~ 138 清 除 使 能 寄 存 器 
Ox200 PENDO R/W 0x0000.0000 断 0 -31 置 位 挂 起 寄存 器 
0x204 PEND1 R/W 0x0000.0000 断 32 -63 置 位 挂 起 寄存 器 
0x208 PEND2 R/W 0x0000.0000 断 64 ~95 置 位 挂 起 寄存 器 
0x20C PEND3 R/W 0x0000.0000 断 96 ~ 127 置 位 挂 起 寄存 器 
0x210 PEND4 R/W 0x0000.0000 断 128 -138 置 位 挂 起 寄存 器 
0x280 UNPENDO R/W 0x0000.0000 断 0 -31 清除 挂 起 寄存 器 
0x284 UNPEND1 R/W 0x0000.0000 断 32 -63 清除 挂 起 寄存 器 
0x288 UNPEND2 R/W 0x0000.0000 断 64 ~ 95 清除 挂 起 寄存 器 
0x28C UNPEND3 R/W 0x0000.0000 断 96 ~ 127 清除 挂 起 寄存 器 
0x290 UNPEND4 R/W 0x0000.0000 断 128 -138 清除 挂 起 寄存 器 
0x300 ACTIVEO RO 0x0000.0000 断 0 -31 激活 位 寄存 器 
0x304 ACTIVF1 RO 0x0000. 0000 断 32 ~ 63 激活 位 寄存 器 
0x308 ACTIVE2 RO 0x0000.0000 断 64 ~ 95 激活 位 寄存 器 
0x30C ACTIVE3 RO 0x0000.0000 断 96 ~ 127 激活 位 寄存 器 
0x310 ACTIVE4 RO 0x0000.0000 断 128 ~ 138 激活 位 寄存 器 
0x400 PRIO R/W 0x0000.0000 断 0 -3 优先 级 寄存 器 
0x404 PRII R/W 0x0000.0000 断 4 -7 优先 级 寄存 器 
0x408 PRI2 R/W 0x0000.0000 断 8 -11 优先 级 寄存 器 
0x40C PRI3 R/W 0x0000.0000 断 12 ~ 15 优先 级 寄存 器 
0x410 PRI4 R/W 0x0000.0000 断 16 ~ 19 优先 级 寄存 器 
0x414 PRIS R/W 0x0000.0000 断 20 -23 优先 级 寄存 器 
0x418 PRI6 R/W 0x0000.0000 断 24 -27 优先 级 寄存 器 
0x41C PRI7 R/W 0x0000.0000 断 28 -31 优先 级 寄存 器 
0x420 PRIS R/W 0x0000.0000 断 32 -3 优先 级 寄存 器 
0x424 PRI9 R/W 0x0000.0000 断 36 -39 优先 级 寄存 器 
0x428 PRI10 R/W 0x0000.0000 断 40 -43 优先 级 寄存 器 
0x42C PRI11 R/W 0x0000. 0000 断 44 ~47 优先 级 寄存 器 
0x430 PRI12 R/W 0x0000.0000 断 48 -31 优先 级 寄存 器 
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選 移 量 名 。 称 | 类 型 复 位 描 。 迷 
0x434 PRI13 R/W 0x0000.0000 中 断 52 ~ 55 优先 级 寄存 器 
0x438 PRI14 R/W 0x0000.0000 中 断 56 ~59 优先 级 寄存 器 
0x43C PRI15 R/W 0x0000. 0000 中 断 60 ~ 63 优先 级 寄存 器 
0x440 PRI16 R/W 0x0000. 0000 中 断 64 ~ 67 优先 级 寄存 器 
0x444 PRI17 R/W 0x0000.0000 中 断 68 -71 优先 级 寄存 器 
0x448 PRI18 R/W 0x0000.0000 中 断 72 -75 优先 级 寄存 器 
0x44C PRI19 R/W 0x0000.0000 中 断 76 -79 优先 级 寄存 器 
0x450 PRI20 R/W 0x0000.0000 中 断 80 ~ 83 优先 级 寄存 器 
0x454 PRI21 R/W 0x0000.0000 中 断 84 -87 优先 级 寄存 器 
0x458 PRI22 R/W 0x0000.0000 中 断 88 -91 优先 级 寄存 器 
0x45C PRI23 R/W 0x0000.0000 中 断 92 ~ 95 优先 级 寄存 器 
0x460 PRI24 R/W 0x0000.0000 中 断 96 ~ 99 优先 级 寄存 器 
0x464 PRI25 R/W 0x0000.0000 中 断 100 ~ 103 优先 级 寄存 器 
0x468 PRI26 R/W 0x0000.0000 中 断 104 ~ 107 优先 级 寄存 器 
0x46C PRI27 R/W 0x0000.0000 中 断 108 -111 优先 级 寄存 器 
0x470 PRI28 R/W 0x0000.0000 中 断 112 ~ 115 优先 级 寄存 器 
0x474 PRI29 R/W 0x0000.0000 中 断 116 ~ 119 优先 级 寄存 器 
0x478 PRI30 R/W 0x0000.0000 中 断 120 ~ 123 优先 级 寄存 器 
0x47C PRI31 R/W 0x0000.0000 中 断 124 ~ 127 优先 级 寄存 器 
0x480 PRI32 R/W 0x0000.0000 中 断 128 ~ 131 优先 级 寄存 器 
0x484 PRI33 R/W 0x0000.0000 中 断 132 ~ 135 优先 级 寄存 器 
0x488 PRI34 R/W 0x0000.0000 中 断 136 -138 优先 级 寄存 器 
OxEOO SWTRIG WO 0x0000.0000 软件 触发 中 断 寄存 器 

















7.2 SysTick 与 NVIC 固件 库 函 数 


SysTick 固件 库 


系统 定时 需 的 API 很 简单 ， 大 致 分 为 两 个 盟 数 组 : 配置 和 使 能 SysTick 的 常用 函数 ，Sy- 
sTick 中 断 处 理 程序 的 常用 函数 。 
(1) 配置 和 使 能 SysTick 的 常用 函数 
e SysTickEnable( ) 。 
e SysTickDisable( ) 。 
e SysTickPeriodSet( ) 。 
e SysTickPeriodGet( ) 。 
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e SysTickValueGet( ) 。 

(2) SysTick 中 断 处 理 程序 的 和 常用 函数 
e SysTickIntRegister( ) 。 

e SysTickIntUnregister( ) 。 

e SysTickIntEnable( ) 。 

e SysTickIntDisable( ) 。 


NVIC 固件 库 


中 断 控制 器 API 函数 的 主要 功能 是 管理 由 NVIC 使 用 的 中 断 向 量 表 对 中 断 请 求 的 分 配 。 
注册 中 断 处 理 程序 就 是 将 其 地 址 插入 到 中 断 向 量 表 相 应 位 置 即 可 。 注 意 ， 如 果 将 未 经 注册 的 
中 断 处 理 程序 用 来 处 理 中 断 时 ， 将 会 产生 一 个 中 断 错误 。 因 此 ， 只 有 在 处 理 程序 注册 之 后 方 
可 使 能 中 断 源 ， 而 应 在 处 理 程序 注销 前 禁止 中 断 源 。 

中 断 控制 器 的 API 也 可 大 致 分 为 以 下 3 个 函数 组 : 

① 中 断 服务 函数 注册 与 注销 。 

② 中 断 使 能 与 禁止 。 

@) 中 断 优先 级 。 

(1) 中 断 服务 函数 注册 与 注销 的 常用 函数 

e IntRegister( ) 。 

e IntUnregister( ) 。 

(2) 中 断 使 能 与 禁止 的 常用 函数 

e IntEnable( ) 。 

e IntDisable( ) 。 

e IntMasterEnable( ) 。 

e IntMasterDisable( ) 。 

(3) 中 断 优 先 级 的 常用 函数 

e IntPrioritySet( ) 。 

e IntPriorityGet( ) 。 

详细 的 NVIC 固件 库 功能 介绍 请 参考 书后 附录 E。 


本 小 节 将 以 中 断 优先 级 为 例 来 介绍 基于 固件 的 NVIC 编程 与 测试 方法 。 
1) 中 断 优先 级 程序 测试 接线 图 如 图 7-1 所 示 。 
2) 中 断 优先 级 程序 。 


ノノ 水 兴 米 炒米 米 玉米 洲 沙洲 炒米 炒米 炒米 洲 洲 米 炒米 炒米 洲 洲 米 炒米 米 玉米 洲 沙洲 炒米 炒米 炒米 洲 米 米 米 炒米 炒米 洲 米 米 洲 米 炒米 洲 米 洲 米 米 米 炒米 米 洲 沙洲 炒 炒 
// 文件 名 :interrupts. c 

// 来 源 :根据 TI 例 程 改编 

// 功能 描述 :该 例 介 绍 了 Cortex - M4 微 处 理 器 的 NVIC 中 断 抢占 和 尾 链 功能 。 骨 套 中 

// ， 断 是 对 具有 相同 优先 级 .优先 级 递增 和 递减 的 多 个 中 断 的 合成 。 当 优先 级 递增 时 将 会 
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// 产 和 4 








进入 中 断 服务 
程序 指示 灯 




















TM4C1 


23GH6PM 


图 7-1 中 断 优先 级 程序 测试 接线 图 


E 抢 占 ;而 对 于 相同 优先 级 或 递减 优先 级 的 情况 ,中 断 间 会 产 4 
// ( 尾 链 )。 当 前 挂 起 与 执行 





背靠背 的 中 断 处 理 





LT 





的 中 断 都 会 通过 UART 在 Putty 上 显示 出 来 ,在 执行 中 断 服 











//， 务 程序 时 ,不 但 可 在 Putty 上 显示 其 中 断 状态 ,而 
// (RGB) 来 独立 地 指示 相应 的 中 断 状 态 ,并 且 在 退 ; 
// 同时 ,有 条 件 的 读者 可 以 通过 如 图 7-1 所 示 的 示波器 来 观测 开关 时 间 ,或 者 用 逻辑 分 析 
// ， 仪 来 观察 尾 链 的 速度 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 


#include 




















< stdint. h > 

< stdbool. h > 
"inc/hw_ints. h" 
"inc/hw_memmap. h" 
"inc/hw_nvic. h" 
"inc/hw_types. h" 

" driverlib/ debug. h" 

" driverlib/fpu. h" 

" driverlib/gpio. h" 

" driverlib/interrupt. h" 
" driverlib/pin_map. h" 
" driverlib/rom. h" 

" driverlib/sysctl. hy" 

" driverlib/systick. h" 

" driverlib/uart. h" 
"utils/uartstdio. h" 





也 可 利用 PF1 - PF2 端口 外 接 的 板 载 LED 


























中 断 服务 程序 之 前 使 LED 熄灭 。 








// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


// 接 收 到 的 中 断 计数 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


volatile uint32_t g_ui32Index; 


// ネネ ポポ ネネ ポ ネ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 
// 当 人 处理 I NT_GPIOA 中 断 時 的 g_ui32Index 值 
// ネネ ポポ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ネネ ポポ ネネ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 


volatile uint32_t g_ui32GPIOa; 











// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボネ ポ ネ ポポ ポポ 


// 当 处 理 INT_GPIOB 中 断 時 的 g_ui32Index 值 
ノノ / ネネ ポポ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 


volatile uint32_t g_ui32GPIOb; 











// ネネ ネネ ネネ ポポ ボネ ポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


// 当 处 理 1 NT_GPIOC 中 断 时 的 g_ui32Index 值 


// ネネ ボネ ネネ ポポ ボネ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


volatile uint32_t g_ui32GPIOc; 











// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ 
、 N= ヽ Ne) 

// 发 生 固件 库 错 误 时 调用 此 错误 处 理 例 程 

// ネネ ネネ ネネ ポポ ネネ ポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ 

#ifdef DEBUG 


void 
































_ error_ (char * pceFilename ,uint32_t ui32Line ) 
| 


| 
#endif 


ノノ 米 米 米 六 六 米 米 洲 米 玉米 洲 米 洲 米 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 
// 延 退 指 定 的 秒 数 
ノノ 米 米 米 六 六 米 米 洲 米 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 
void 
Delay( uint32_t ui32Seconds) 
| 
// 
// 循 环 等 待 
// 
while( ui32Seconds —— ) 
| 





// 

// 一 直 等 到 SysTick 的 值 小 于 1000 
// 

while( ROM_SysTickValueGet( ) > 1000 ) 
| 

| 


// 

// 一 直 等 到 SysTick 的 值 大 于 1000 
メア 

while( ROM_SysTickValueGet( ) <1000 ) 
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// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


// 通 过 UART 在 Putty 上 显示 中 断 状 态 , 即 显示 当前 的 激活 和 挂 起 的 中 断 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


void 





DisplayIntStatus ( void ) 


| 


uint32_t ui32Temp; 


// 
// 显 示 当 前 的 激活 中 断 
// 


ui32Temp =HWREC(NVIC_ACTIVEO) ; 
UARTprintf(" \r 激活 ; %c%c%c",(ui32Temp &1) 231, 
(ui32Temp & 2) 7 2 ,(u32Temp & 4) 13 ); 


/ 
// 显 示 当 前 挂 起 的 中 断 
// 


ui32Temp = HWREG(NVIC_PENDO ) ; 
UARTprintf(" 挂 起 : %c%c%c" ,(ui32Temp &1) 3 1, 
(ui32Temp & 2) 7 2 :" ,(ui32Temp & 4) 13 :”); 








// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ 


//GPIOA 的 中 断 服务 程序 ,这 里 只 简单 地 保存 中 断 序列 号 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポ ポポ 


void 














IntCPIOa( void ) 


| 


グ 
// 设 置 PF1 为 高 
// 
ROM_GPIOPinWrite( GPIO_PORTF_BASE, GPIO_PIN_1 ,GPIO_PIN_1); 











[en 
レ 





来 点 亮 板 载 的 LED_R ,以 指示 进入 该 路 的 中 断 服务 程序 











ZL 
// 将 当前 的 中 断 状态 显示 在 Putty 上 
ノ // 


DisplayIntStatus( ) ; 


ノ / 
// 等 待 2s 
ZU 
Delay(2 ) ; 


ZN 

// 保 存 并 使 其 中 断 序列 号 增 1 
// 

g_ui32GPIOa = g_ui32Index ++ ; 








// 
// 设 置 PF1 为 低 电 平 使 LED_R 熄灭 ,以 指示 退出 该 路 中 断 服务 程序 
// 


ROM_GPIOPinWrite( GPIO_PORTF_BASE, GPIO_PIN_1 ,0) ; 


// ネネ ボネ ネネ ボネ ポポ ポポ ポポ ポポ ボネ ボボ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


//GPIOB 的 中 断 服务 程序 , 即 触发 CPIOA 中 断 和 保存 其 中 断 序列 号 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 





void 

IntGPIOb( void) 

| 
Kf. 
// 设 置 PF2 为 高 日 
KS. 
ROM_GPIOPinWrite( GPIO_PORTF_BASE,GPIO_PIN 2,GPIO_PIN 2 ) ; 











来 点 亮 板 载 的 LED_B ,以 指示 进入 该 路 的 中 断 服务 程序 


此 
レ 














メ / 
// 将 当前 的 中 断 状态 显示 在 Puty 上 
ノ // 


DisplayIntStatus( ) ; 


// 
// 软 件 触 发 CPIOA 中 断 

// 

HWREG( NVIC_SW_TRIG) =INT_GPIOA - 16: 





ノ // 
// 将 当前 的 中 断 状态 显示 在 Putty 上 
ZL 


DisplayIntStatus( ) ; 


ノ // 
等 待 2 
// 
Delay(2) ; 


ZN 

// 保 存 并 使 其 中 断 序列 号 增 1 
// 

g_ui32GPIOb = g_ui32Index ++ ; 


// 
// 设 置 PF2 为 低 





[也 
| 


F 使 LED_B 熄灭 ,以 指示 退出 该 路 中 断 服 务 程序 
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ん 
ROM_CPIOPinWrite(CPIO_PORTF_BASE,CPIO_PIN_2.0) : 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ネネ ポポ ネネ 


//GPIOC 的 中 断 服 务 程序 , 即 触发 CPIOB 中 断 和 保存 其 中 断 序列 号 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 








void 
IntGPIOc( void ) 
| 
// 
// 设 置 PF3 为 高 电 平 来 点 亮 板 载 的 LED_G ,以 指示 进入 该 路 的 中 断 服 务 程序 
// 
ROM_GPIOPinWrite( CPIO_PORTEF_BASE,GPIO_PIN_3 ,GPIO_PIN_3 ) : 























// 
// 将 当前 的 中 断 状态 显示 在 Putty 上 
// 


DisplayIntStatus( ) ; 


/ 
// 软 件 触 发 CPIOB 中 断 

// 

HWREG( NVIC_SW_TRIG) =INT_GPIOB - 16; 





KS 
// 将 当前 的 中 断 状态 显示 在 Putty 上 
77 


DisplayIntStatus( ) ; 


A 
// 等 待 2s 
ZL 
Delay(2) ; 


Kf. 

// 保 存 并 使 其 中 断 序列 号 增 1 
シタ 4 

g_ui32CPIOc = g_ui32Index ++ ; 











// 
// 设 置 PF3 为 低 电 平 使 LED_G 熄灭 ,以 指示 退出 该 路 中 断 服务 程序 
// 


ROM_GPIOPinWrite( GPIO_PORTF_BASE ,GPIO_PIN_3 ,0) ; 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 玉米 
// 配 置 UART 及 其 引 脚 ,这 必须 在 调用 UARTprintf( ) 函数 前 完成 


// ネネ ボネ ネネ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ 
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void 
ConfigureUART( void ) 
| 
// 
// 使 能 在 UART 中 使用 的 CPIO 外 设 
ノ // 
ROM_SysCHPeripheralEnable( SYSCTL_PERIPH_GCPIOA) ; 





// 

// 使 能 UARTO 

// 
ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_UARTO ) ; 





// 
// 配 置 UART 模式 中 的 CPIO 引 脚 
7 
ROM_GPIOPinConfigure( CPIO_PA0_UORX ) ; 
ROM_GPIOPinConfigure( CPIO_PA1_UOTX ) ; 
ROM_GPIOPinTypeUART(CPIO_PORTA_BASE ,CPIO_PIN_0 | GPIO_PIN_1); 

















// 
// 使 用 内 部 16 MHz 振荡 器 作为 UART 时 钟 源 
// 


UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 





2 
// 初 始 化 UART 的 控制 台 IO 
2 


UARTStdioConfig( 0,115200 ,16000000 ) ; 


// ネネ ポポ ネネ ポ ネ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネ ポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ネネ 
// 主 程序 。 它 检查 被 处 理 的 中 断 在 具有 相同 优先 级 .优先 级 递增 和 递减 时 ,执行 顺序 是 否 正确 。 
// 以 及 练习 中 断 抢占 式 优先 级 和 尾 链 的 使 用 


// * ま ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ギ 六 玉 玉 ポポ 玉 ※ 


























int 
main( void ) 
| 
uint32_t ui32Error; 


// 

// 使 能 扩展 (lazy) 堆栈 的 中 断 处 理 程序 

// 这 将 允许 在 中 断 服务 程序 间 使 用 浮 点 指令 ,但 需 花 费 额外 的 堆栈 空间 
// 

ROM_FPULazyStackingEnable( ) ; 














// 
// 设 置 时 钟 直接 从 晶振 运行 
// 
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ROM_SysCIClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_0SC_MAIN | 


























SYSCTL_XTAL_1 
// 使 能 程序 中 所 使 用 的 外 设 
// 


6MHZ) ; 


ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_CPIOE) ; 


// 

// 初 始 化 UART 
// 

ConfigureUART( ) ; 


UARTprntf("\033[ 2J 中断 优先 级 示例 


ノ / 


\n" ) ; 











// 配 置 PF1 ~ PF3 为 CPIO 输出 以 指示 中 断 服 务 程序 的 进入 /退出 





// 





ROM_GPIOPinTypeGPIOOutput( GPIO_PORTF_BASE, GPIO_PIN_1 | CPIO PIN_2 | 





GPIO_PIN_3 ) ; 


ROM_GPIOPinWrite( CPIO_PORTF_BASE,GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3,0) ; 


// 
/设置 并 使 能 系统 定时 器 。 它 将 用 于 
// 期 将 设置 为 1s 

// 
































P 断 服务 程序 中 延迟 循环 的 参考 。 系 统 定 时 融 的 周 


ROM_SysTickPeriodSet( ROM_SysCtlClockGet( ) ) ; 





ROM._ SysTickEnable( ) ; 


// 

// 复 位 错误 指示 器 
// 

ui32Error =0: 





// 
// 使 能 中 断 到 处 理 器 
// 


ROM_IntMasterEnable( ) ; 


// 
/ 合 能 中 断 

// 

ROM_IntEnable( INT_GPIOA) ; 
ROM_IntEnable(INT_GPIOB) ; 
ROM_IntEnable(INT_GPIOC) ; 





// 





T 


/显示 相同 中 断 优 先 级 的 测试 从 此 开始 





// 
UARTprintf(" \n 相同 优先 级 \n" ) ; 








// 
// 设 置 相同 优先 级 ,其 中 0x00 为 最 高 优先 级 
// 


ROM_IntPrioritySet(INT_CPIOA,0x00) ; 
ROM_IntPrioritySet( INT_GPIOB ,0x00) : 
ROM_IntPrioritySet(INT_CPIOC ,0x00 ) ; 


// 
// 复 位 中 断 标志 
// 


g_u132GPIOa =0; 
g_ui32GPIOb =0; 
g_ui32GPIOc =0: 
g_ui32Index =1; 


// 
// 软 件 触发 CPIOC 中 断 

// 

HWREC(NVIC_SW_TRIC) =INT_GPIOC - 16; 





ノ // 
// 将 当前 的 中 断 状 态 显示 在 Putty 上 
4 


DisplayIntStatus( ) ; 


メ XZ 
// 确 认 以 正确 的 顺序 处 理 中 断 
// 
if((g_ui32GPIOa!=3) || (g_ui32GPIOb!=2) || (g_ui32GPIOc!=1)) 
| 

ui32Error | =1; 


// 
等 待 2 
// 
Delay(2): 





// 

// 显 示 递 减 中 断 优先 级 测试 从 此 开始 
// 

UARTprint( " \n 递减 优先 级 \n" ) ; 





// 
// 设 置 递 减 中 断 优 先 级 ( 即 C >B > A) 
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// 

ROM_IntPrioritySet(INT_CPIOA,0x80) ; 
ROM_IntPrioritySet(INT_GPIOB,0x40 ) ; 
ROM_IntPrioritySet( INT_GPIOC,0x00 ) ; 


// 
// 复 位 中 断 标志 
// 


g_u132CPIOa =0; 
g_ui32GPIOb =0; 
g_ui32GPIOc =0: 
g_ui32Index =1; 


// 
// 软 件 触发 CPIOC 中 断 

// 

HWREG( NVIC_SW_TRIG) =INT_GPIOC - 16; 


ノ // 
// 将 当前 的 中 断 状 态 显 示 在 Puty 上 
// 


DisplayIntStatus( ) ; 


// 
// 确 认 以 正确 的 顺序 处 理 中 断 
// 
if((g_ui32GPIOa!=3) || (g_ui32GPIOb!=2) || (gmi32GPIOc!=1) ) 
| 
ui32Error | =2; 


// 
// 等 待 2s 
// 
Delay(2) ; 





// 显 示 递 增 中 断 优先 级 测试 从 此 开始 
UARTprintf(" \n 递增 优先 级 \n" ) ; 


// 

// 设 置 递增 中 断 优先 级 ( 即 C <B <A) 
// 
ROM_IntPrioritySet(INT_GCPIOA,0x00 ) ; 
ROM_IntPrioritySet(INT_GPIOB,0x40 ) ; 
ROM_IntPrioritySet(INT_GPIOC,0x80 ) ; 
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// 
/复位 中 断 标志 
// 

g_ui32GPIOa = 0: 
g_ui32GPIOb = 0 
g_ui32GPIOc =0: 
g_u132Index = 1 : 


// 
// 软 件 触发 CPIOC 中 断 

// 

HWREG( NVIC_SW_TRIG) =INT_GPIOC - 16; 


// 
// 将 当前 的 中 断 状 态 显 示 在 Putty 上 
ZN 


DisplayIntStatus( ) ; 


// 
// 确 认 以 正确 的 顺序 处 理 中 断 
// 


if( (g_ui32GPIOal=1) || (g_ui32GPIOb!=2) || (g_ui32GPIOc!=3)) 


| 
ui32Error | =4; 


// 
// 等 待 2s 
// 
Delay(2) ; 


// 
// 禁 止 中 断 

// 

ROM_IntDisable( INT_GPIOA) ; 
ROM_IntDisable( INT_GPIOB) ; 
ROM_IntDisable(INT_GPIOC ) ; 


// 

// 禁 止 处 理 器 中 断 

// 
ROM_IntMasterDisable( ) ; 


// 

// 显 示 测 试 结 

// 

UARTprintf(" \nInterrupt Priority = : %s >:%s 


(ui32Error & 1) ?9" 失 败 " : "测试 通过 


く : % s\n" 7 


WD 
9 
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(ui32Error & 2) ?失败 "” : "测试 通过 " ， 
(ui32Pmor & 4) ?失败 "” : "测试 通过 " ) ; 


























从 攻 。 人 | 建 的 工 各 
// 无 限 循环 : 同 "Inclndes 
ノ // 
。 : 攻 utils 
while1) > [多 interrupts_ccs.cmd 
| , Be | 
| 应 startup-ccsc > 
国 macros.ini_initial 
国 TM4C123G.ccxml [Active] 





3) 在 CCS6 中 创建 nterrupts 工程 ， 如 图 7-2 所 示 。 
4) 添加 startup_ccs. c 文件 ， 然 后 声明 中 上 断 服务 程 


序 (IntGPIOa 、IntGPIOb 、IntGPIOc ) 为 外 部 程序 ， 并 将 其 添加 到 startnp_ccs. c 中 断 向 量 表 
的 相应 位 置 ， 如 图 7-3 所 示 。 














图 7-2 创建 的 interrupts 工程 













OTIResource Explorer | 回 interrupts.c % IElstartup 


interrupts/interrupts.C 
ここ ここ ここ と とこ と ここ ここ ここ ここ と と 本 ます と と を を を を と を と を と と を まそ 
#pragma DATA_SECTION(g_pfnVectors, ".intvecs") 


void (* const g pfnVectors[])(void) = 中 断 向 量 表 
{ 










(void (*) (void) )((uint32 t)&__ STACK_TOP) , 
1nitia] stack po 



















ResetTSR, // The reset hand1er 
Nm1SR, // The NMI handler 
Fau1tTSR, 添加 的 中 断 。” 和// The hard fault handle 
IntDefaugHandler, 服务 程序 // The MPU fault handler 
~ # ud < 
ラッ = 7 WE 
TntDefau1tHandler, // The PendSV handler 


TntDefau]tHand]er The SvsTick handler 


ITntGPT0a, 77 GPIO Port A 
IntGPIOb, // GPIO Port B 
TntGPT0c, // GPTO Port C 
FHa GPTO_POTT PD 














图 7-3 添加 中 断 服务 程序 到 中 断 向 量 表 中 





5) 编译 interrupts 工程 生成 可 执行 的 . out 格式 文件 ， 如 图 7-4 所 示 。 


日 Console 3 忆 他 图 | 轴 加 读 | 呈 上 目 ~ 上 > 一 日 匠 Problems 器 | 9 Advice = 日 
CDT Build Console [interrupts] 
<Linking> 


Description 
"Finished building target:(interrupts.out" 


"C:/ti/ccsv5/utils/tiobj2bin/tiobj2bin 全 
"interrupts.out" "interrupts.bin" 


"C:/t1/ccsv5/too1s/compiler/arm_5.1.1/bi 下 /armofd" 0 介 徐 選 , 0 條 警告 











Oitems 0 








"C:/ti/ccsv5/tools/compiler/arm 5.1. 1/birarmhex" 
"C:/ti/ccsv5/utils/tiobj2bin/mkhex4bin" 1 1 





ネネ まま Build Finished ** ネ ネネ | 






































图 7-4 工程 编译 的 结果 生成 可 执行 的 . out 文件 








T 


6) 在 EK-TM4C123GXL 板 上 对 程序 进行 调试 与 测试 。 

① 调试 。 

a) 单 击 工具 栏 中 如 图 7-5 所 示 的 图 标 及 TM4C123G. cexml 文件 ， 进 入 调试 视图 。 
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b) 首先 单 击 工具 栏 中 的 圆 图 标 连接 EK - TM4C123GXL 板子 ， 然 后 单 击 了 可 图 标 导 入 . out 
文件 到 板 中 ， 如 图 7-6 所 示 。 




















| 茵 Debug 8 | 家 | | 
4 TM4C123G.ccxml [Code Composer Studio - Device Debugging] 
4 Stellaris In-Circuit Debug Interface_0/CORTEX_M4_0 (Suspended - 
main() at interrupts.c:332 Ox0000026C 
_C_int000 at baot.asm:217 Ox00000B3A (Lc_int00 does not conl 


E/startup_ccs.c - Code Composer St 





igate Pit Run Scripts Winde 


ず マ < 
N2 [1 TM4C123G.ccxml | 











图 7-5 进入 调试 视图 图 7-6 导入 编译 生成 的 . out 文件 到 EK - TM4C123CXL 中 





c) 将 变量 g_m32GPIOa 、g_ui32CPIOb 、g_ui32GPIOc 和 g_ui32Index 添加 到 观察 窗口 
中 ， 如 图 7-7 所 示 。 

d) 在 如 图 7-8 所 示 的 位 置 放置 一 个 断 点 ， 接 着 让 程序 运行 到 该 断 点 处 ， 再 打开 PuTTY 
(COM7 、 波 特 率 设置 为 115200Baud ) 。 然 后 单 步 执行 程序 ， 当 执行 完 UARTprintf( "\033[ 2J 
中 断 优 先 级 示例 \n" ) 语 名 后 ,在 PuTTY 上 出 现 “ 中 断 优 先 级 示例 ”， 说 明 此 前 程序 运行 正 
确 。 最 后 取消 该 断 点 。 






















ミ Yer [a interrupts.c 3 固 startup_ccs.c 昌 
| 运行 到 断 点 处 医 e the UART. 


ConfigureUART(); 

















| Varia... 并 Expre. 2 
旋 斩 | 归 甘 演 | 区 时 | 名 





DUARTPrintf("™ 033[2J] 中 靳 优先 级 未 全 Nn™): 



























"gq_ui32GPIOb" 
Et "g_uyi32GPIOc" 

















图 7-7 添加 到 观察 窗口 中 的 变量 到 7-8 在 UARTprintf. 处 放置 断 点 及 单 步 执行 结果 

















e) 相同 优先 级 。 在 HWREG( NVIC_SW_TRIG) = INT_GPIOC - 16 和 GPIOC 中 断 服务 程 
序 中 的 ROM_GPIOPinWrite(GPIO_PORTF_BASE,GPIO_PIN_3,GPIO_PIN_3 ) 、DisplayIntStatus( ) 
和 HWREC(NVIC_SW_TRIC ) =INT_GPIOB - 16 处 各 设置 一 个 断 点 。 

当 程 序 单 步 执行 完 HWREG(NVIC_SW_TRIG) = INT_GPIOC - 16 语句 后 ， 触 发 GPIOC 中 
断 ; 在 程序 单 步 执行 到 DisplayIntStatus( ) 时 ，LED_G (绿色 LED) 点 亮 ， 指 示 此 时 已 进入 
GPIOC 中 断 服务 程序 ， 当 单 步 执行 完 DisplayIntStatus( ) 语 名 时， 在 PuTTY 上 的 显示 序列 号 为 
3 (GPIOC 中 断 服务 程序 ) 的 中 断 被 激活 ， 如 图 7-9 所 示 。 

从 图 7-9 的 显示 与 硬件 测试 结果 来 看 ， 执 行 到 该 断 点 ， 激 活 序列 号 为 3 (GPIOC 中 断 服 
务 程序 ) 的 中 断 和 点 亮 LED_G 符合 该 段 程 序 所 表达 的 思想 。 注 意 : 此 时 应 删除 使 用 过 的 所 
有 断 点 ， 以 便 后 续 设置 断 点 之 需 。 

继续 单 步 运行 ， 当 程序 执行 完 HWREG( NVIC_SW_TRIG ) = INT_CPIOB - 16 这 条 语句 
后 ， 触 发 CPIOB 中 断 。 但 由 手中 断 GPIOB 和 CPIOC 为 同等 优先 级 ，GPIOB 中 断 不 能 强占 
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を COM7 - PuTTY SEE | | FW CCS DE EAN c - Code Composer Studio ! 











条 Re 5 | 加 jnterrupts. CR 3 | 回 StartuD_CCS.C 


{ 





点 亮 LED_G( 绿 色 发 光 LED) 


指示 进入 GPIOC 


中 断 服务 程序 ノシ current ee 显示 当前 中 断 状态 





DisplayIntStatus(); 


// 

// Trigger the INT_GPIOB interrupt. 

// 

HMREG(NVTC_ SM TRIG) A 
pi 』 




















Ni 
7 也 


图 7-9 単 歩 拠 行 完 DisplayIntStatus( ) 后 的 测试 结 呈 





GPIOC 中 断 的 执行 权 ， 因 此 GPIOB 中 断 被 挂 起 ， 而 GPIOC 中 断 仍 处 于 激活 状态 ， 如 图 7-10 
所 示 。 

当 执行 完 GPIOC 的 中 断 服 务 程序 时 (LED_G 想 火 ), GPIOB 中 断 被 激活 ， 继 续 单 步 执 
行 指示 进入 CPIOB 中 断 服务 程序 的 蓝 色 LED_B 被 点 亮 。 这 时 在 HWREC(NVIC_SW_TRIC ) 
=INT_GPIOA -16 和 CPIOA 的 中 断 服 务 程 序 中 的 DisplayIntStatus( ) 处 各 放置 一 个 断 点 。 当 
程序 执行 完 HWREG(NVIC_SW_TRIG) = INT_GPIOA - 16 这 条 语句 后 ， 和 触发 CPIOA 中 断 。 
但 由 于 中 断 GPIOA 和 GPIOB 为 同等 优先 级 ，GPIOA 中 断 不能 強 占 GPIOB 中 断 的 执行 权 ， 因 
此 GPIOA 中 断 被 捧 起 , 面 GPIOB 中 断 仍 处 于 激活 状态 ， 如 图 7-11 所 示 。 


















































gp coM7 - PuTTY le EE x 下 coM7 - PuTTY し 回 


中 断 优 先 级 示例 


相同 优先 级 
激活 : 2 挂 起 : 1 目 














图 7-10 GPIOC 中 断 处 于 激活 状态 图 7-11 ”GPIOB 中 断 处 于 激活 状态 
而 CPIOB 中 断 被 挂 起 而 GPIOA 中 断 被 挂 起 


当 执 行 完 CPIOB 的 中 断 服务 程序 时 (LED_B 熄灭 ) ，GPIOA 中 断 被 激活 ， 继 续 单 步 执 
行 指 示 进 入 CPIOA 中 断 服务 程序 的 红色 LED_R 被 点 亮 ， 此 时 在 PuTTY 上 显示 的 中 断 状 态 如 
图 7-12 所 示 。 

f) 递减 优先 级 。 首 先 在 UARTprintf(" \n 递减 优先 级 \n" ) 处 放置 一 个 断 点 ， 让 程序 运行 
到 递减 优先 级 程序 段 。 再 按 上 述 放置 断 点 ， 当 程序 执行 完 HWREC(NVIC_SW_TRIG) =INT_ 
GPIOB - 16 这 条 语句 后 ， 触 发 GPIOB 中 断 。 但 由 于 GPIOB 中 断 的 优先 级 比 CPIOC 中 断 低 , 
因此 CPIOB 中 断 被 挂 起 ， 而 GPIOC 中 断 仍 处 于 激活 状态 ， 如 图 7-13 所 示 。 

当 执 行 完 GPIOC 的 中 断 服务 程序 时 (LED_G 熄灭 ) ，GPIOB 中 断 被 激活 ， 继 续 单 步 执 
行 指示 进入 GPIOB 中 断 服 务 程序 的 蓝 色 LED_B 被 点 亮 。 

当 程 序 执行 完 HWREG (NVIC_SW_TRIG) = INT_GPIOA - 16 这 条 语句 后 ， 触 发 CPIOA 
中 断 。 但 由 于 GPIOA 中 断 的 优先 级 比 CPIOB 中 断 低 ， 因 此 CPIOA 中 断 被 挂 起 而 GPIOB 
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中 断 仍 处 于 激活 状态 ， 如 图 7-14 所 示 。 








coM7 - PuTTY | 一 | 加] 证: 全 








次 coM7 - PuTTY ee Xx 中 断 优先 级 示例 
中 断 优 先 级 示例 











图 7-12 GPIOA 中 断 服 务 程序 被 激活 較 7-13 ”GPIOC 中 断 处 于 激活 状态 

而 CPIOB 中 断 被 挂 起 

当 执 行 完 CPIOB 的 中 断 服务 程序 时 (LED_B 熄灭 ) ，GPIOA 中 断 被 激活 ， 继 续 单 步 执 

行 指示 进入 CPIOA 中 断 服务 程序 的 红色 LED_R 被 点 亮 ， 此 时 在 PuTTY 上 显示 的 中 断 状 态 如 
图 7-15 所 示 。 


1 






































gp CoM7 - PuTTY | = | 回 王 ベ ー gg CoM7 - PuTTY | 選 」 回 恨 : 編 
中 断 优 先 级 示例 中 断 优 先 级 示例 





























图 7-14 ”GPIOB 中 断 处 于 激活 状态 图 7-15 GPIOA 中 断 服 务 程序 被 激活 

而 GPIOA 中 断 被 挂 起 

g) 递增 优先 级 。 首 先 在 UARTprintf(" \n 递增 优先 级 \n" ) 处 放置 一 个 断 点 ， 计 程序 运行 

到 递增 优先 级 程序 段 。 再 按 上 述 放 置 断 点 ， 当 程序 单 步 执行 完 HWREG( NVIC_SW_TRIG) = 

INT_CPIOC -16 语句 后 ， 触 发 GPIOC 中 断 , 在 程序 单 步 执行 到 DisplayIntStatus( ) 时 ，LED_ 

G( 绿 色 LED) 点 亮 ， 指 示 此 时 已 进入 GPIOC 中 断 服务 程序 ， 如 图 7-16 所 示 。 

当 程序 执行 完 HWREGCNVIC_ SW_TRIG ) =INT_CPIOB - 16 这 条 语句 后 ， 触 发 CPIOB 中 

断 。 由 于 CPIOB 中 断 的 优先 级 比 GPIOC 中 断 高 ， 强 占 CPIOC 中 断 的 执行 权 ， 转 而 运行 GPI- 
OB 中 断 服 务 程 序 (绿色 LED_B 被 点 亮 ， 且 此 时 LED_G 仍 被 点 亮 ) ， 如 图 7-17 所 示 。 



































gp CoM7 - PuTTY ke 回 gp COM7 - PuTTY | = | 回 叶 : 
中 断 优先 级 示例 中 断 优先 级 示例 

相同 优先 级 

沂 ; = 挂 起 


激 活 : 23 挂 起 : 





























图 7-16 GPIOC 中 断 服务 程序 被 激活 图 7-17 GPIOB 中 断 和 GPIOC 中 断 均 处 于 激活 状态 





当 程 序 执行 完 HWREG( NVIC_SW_TRIG) = INT_GPIOA - 16 这 条 语句 后 ， 触 发 GPIOA 
中 断 。 由 于 GPIOA 中 断 的 优先 级 比 GPIOB 中 断 高 ， 因 此 强占 GPIOB 中 断 进 入 GPIOA 中 断 
服务 程序 (红色 LED_R 被 点 亮 ， 此 时 LED_B 和 LED_G 仍 被 点 亮 ， 因 此 发 出 白光 ) ， 如 
图 7-18 所 示 。 
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这 com7 - PuTTY | 回 屋 : 編 

















图 7-18 中断 GPIOA、GPIOB 和 GPIOC 均 激 活 





当 执行 GCPIOA 、CPIOB 和 GPIOC 中 断 服 务 程序 时 ， 过 程 如 图 7-19 所 示 。 





gp COM7 - PuTTY 








型 COM7 - PuTTY 


中 断 优先 级 示例 











图 7-19 


























递增 优先 级 中 断 的 执行 过 程 

















继续 单 步 执行 程序 ， 最 后 的 测试 结果 如 图 7-20 所 示 。 











别 COM7 - PuTTY 


中 断 优 先 级 示例 





ee xX” 


Tnterrupt Priority =: 测试 通过 >: 测试 通过 <: 测试 通过 




















中 断 优先 级 示例 的 测试 结果 


从 以 上 中 断 相同 优先 级 、 中 断 递 减 优先 级 和 递增 优先 级 的 
了 设计 要 求 达到 的 效果 ， 对 读者 加 深 对 中 断 优 先 级 理解 有 较 好 的 促进 作用 。 
② 硬件 测试 。 将 编译 生成 的 . out 文件 导入 到 在 EK - TM4C123GXL 板 中 ， 打 开 PuTTY 
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步调 试 结果 来 看 ， 程 序 实 现 


观察 到 的 中 断 执 行 顺序 和 板 载 LED 的 点 亮 情况 ， 如 图 7-21 所 示 。 


























『 
下 COM7 - PuTTY ll 


3 只 LED 的 点 亮 顺序 和 
进入 的 中 断 服务 程序 顺 
序 相对 应 ， 测 试 结果 验 
证 了 程序 的 正确 性 。 
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图 7-21 在 EK-TM4C123CXL 板 上 的 测试 结果 和 观察 到 的 现象 


在 观察 相同 中 断 优 先 级 和 递减 中 断 优先 级 时 ， 可 以 看 到 这 些 中 断 激 活 和 挂 起 与 指示 其 进 
入 中 断 服 务 程序 的 发 光 LED 对 应 ， 当 被 激活 的 中 断 服务 程序 执行 结束 后 马上 去 执行 被 挂 起 
的 中 断 ， 即 形成 所 谓 的 硝 对 背 ( 尾 链 ) 的 中 断 处 理 。 而 在 观察 递增 中 断 优先 级 时 ， 可 以 看 
到 2 只 LED、3 只 LED 同时 发 光 的 现象 ， 这 是 由 于 其 中 断 服务 程序 还 没有 执行 完成 就 被 其 他 
优先 级 高 的 中 断 所 强占 的 结 
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。。 人 第 9 章 ea 
内 部 集成 电路 接口 (2C) 


PC (Inter - Integrated Circuit) 总 线 通 过 双 线 结构 ( 串 行 数据 线 SDA 和 串 行 时 钟 线 
SCL) 提供 数据 的 双向 传输 与 连接 外 部 PC 设备 的 接口 ， 例 如 串 行 存储 器 (RAM 和 ROM) 、 
网 络 设备 、LCD、 音 频 发 生 器 等 。 此 外 ，I2C 总 线 还 能 在 产品 的 开发 和 制造 过 程 中 用 于 系统 
测试 和 诊断 。TM4C123GH6PM 微 控制 器 提供 了 4 个 PC 模块 ， 能 够 与 总 线 上 的 其 他 DC 设 
备 进 行 读 写 操作 。 

DPC 的 API 提供 了 一 组 用 于 使 用 Tiva I2C 主 从 模块 的 函数 。 即 初始 化 DC 模块 、 发 送 和 
接收 数据 、 获 取 状 态 和 管理 2C 模块 的 中 断 等 。 其 固件 库 函 数位 于 driveriib \ 2c. c 目录 下 ， 
而 driverlib\ i2c.h 包含 了 DPC API 函数 的 所 有 定义 。 


本 章 的 主要 内 容 : 


> DC 单元 
> I2C 固件 库 函 数 ( 见 附录 下 ) 
> 例 程 

















PC 特点 


TM4C123GH6PM 控制 器 具有 以 下 特点 : 
1) 12C 总 线 上 的 设备 可 被 指定 为 主机 或 从 机 。 
① 同时 支持 一 个 主机 或 从 机 发 送 和 接收 的 数据 。 
② 支持 主机 和 从 机 同步 操作 。 
2) 4 种 DC 模式 。 
① 主机 传送 。 
② 主机 接收 。 
@) 从 机 传送 。 
@ 从 机 接收 。 
3) 4 种 传输 速度 。 
① 标准 (100 kbit/s) 。 
② 快速 (400 kbit/s) 。 
736 





③ 快速 模式 + (1 Mbit/s)。 
④ 高速 模式 (3. 33 Mbit/s) 。 
4) 时 钟 低 电 平 超时 中 断 。 


5) 双 从 地 址 功能 。 


6) 干扰 抑制 。 
7) 主机 和 从 机 产生 中 断 。 
① 主机 在 传送 或 接收 数据 结束 〈 或 由 于 错误 退出 ) 产生 中 断 。 
② 从 机 在 主机 向 其 发 送 数据 或 发 出 请 求 时 ， 或 检测 到 START 或 STOP 信号 时 产生 中 断 。 
8) 主机 带 有 仲裁 和 时 钟 同步 功能 ， 支 持 多 主机 与 7 位 寻 址 模式 。 


IC 模块 框图 
PC 模块 框图 如 图 8-1 所 示 。 


I2C 控 制 





I2C 主 机 内 核 









































I2CMTPR I2CSIMR 
| 2CMTPR | | 2CSIMR | 2C VO 选择 
po 
图 8-1 I2C 模块 框图 
EL 
信号 描述 
DPC 接口 的 外 部 信号 及 其 功能 描述 见 表 8-1。 
表 8-1 I2C 信号 (64LQFP) 
引 脚 复 用 / 、 、 
车 名 称 即 编 号 到 即 类 型 缓冲 区 类 型 措 述 
引 脚 名 称 引 脚 编号 引 脚 赋值 引 脚 类 缓冲 区 类 前 述 
12COSCL 47 PB2(3 ) 1/0 OD DPC 模块 0 时 钟 
ICOSDA 48 PB3(3 ) 1/0 oD DPC 模块 0 数据 
12C1SCL 23 PA6( 3 ) 1/O OD DPC 模块 1 时 钟 
12C1SDA 24 PA7( 3 ) 1/0 oD DPC 模块 1 数据 
IC2SCL 59 PE4(3) 1/0 oD DPC 模块 2 时 钟 
12C2SDA 60 PES(3 ) 1/0 OD DPC 模块 2 数据 
12C3SCL 61 PDO(3) 1/0 OD DC 模块 3 时 钟 
12C3SDA 62 PD1(3) 0 oD DPC 模块 3 数据 
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功能 描述 

每 个 2C 模块 都 具有 主机 和 从 机 功能 ， 要 使 其 正常 运转 ，SDA 和 SCL 引 脚 必须 设置 成 
开 漏 形式 。 典 型 的 2C 总 线 配置 如 图 8-2 所 示 。 

1.12C 总线 的 功能 概述 上 拉 电 阻 

PC 总 线 只 使 用 两 个 信号 : SDA 和 人 
SCL。 在 TM4C123GH6PM 微 控制 器 上 ， 
它们 的 名 称 分 别 是 2CSDA 和 PCSCL。 
SDA 是 双向 串 行 数据 线 ，SCL 是 双向 串 行 
时 钟 线 。 当 两 根 线 都 为 高 电 平时 ， 总 线 处 
于 空闲 状态 。 

DPC 总 线 每 次 传输 的 数据 长 度 为 9 
位 ， 其 中 包括 8 位 数据 位 和 1 位 应 答 位 。 每 次 传输 的 字 节 数 没 有 限制 ， 但 是 每 个 字 节 后 面 
必须 紧 跟 1 位 应 答 位 ， 而 且 数 据 传 输 时 必须 首先 传送 最 高 有 效 位 (MSB ) 。 当 接收 器 不 能 接 
收 另 一 个 完整 的 字 节 时 ， 它 会 保持 时 钟 线 SCL 为 低 电 平 ， 并 强制 发 送 器 进入 等 待 状态 。 在 
接收 器 释放 时 钟 线 SCL 之 后 ， 数 据 传 送 将 继续 进行 。 

(1) 开始 和 停止 条 件 

PC 总 线 协议 定义 了 两 种 状态 : 开始 和 停止 ， 以 便 开 始 和 结束 数据 传输 。 当 SCL 为 高 电 
平时 ，SDA 线 上 由 高 电 平 变 为 低 电 平定 义 为 开始 信号 ; 当 SCL 为 高 电 平时 ，SDA 线 上 由 低 
电 平 变 为 高 电 平 被 定义 为 停止 信号 。 符 合 开始 条 件 后 ， 总 线 将 占线 ; 达到 停止 条 件 后 ， 总 线 
将 空间 。 如 图 8-3 所 示 。 


























图 8-2 I2C 总 线 配置 














SCL == 
1STARTI , STOP | 
开始 信号 停止 信号 


图 8-3 12C 总 线 开 始 和 停止 条 件 


STOP 位 决定 数据 周期 在 结束 时 是 停止 还 是 继续 重复 运行 ， 直 到 出 现 重复 的 START 条 
件 。 要 产生 单 次 传输 ， 应 在 DC 主机 从 机 地 址 寄存 器 (2CMSA ) 中 写 入 所 需 的 地 址 ， 并 将 
R/S 位 清 零 ， 在 控制 寄存 器 中 写 人 ACK =X(0 或 1) 、STOP =1、START =1 与 RUN =1, 来 
执行 单 次 传输 并 停止 。 在 传输 完成 后 〈 或 由 于 错误 退出 ) ， 中 断 引 脚 将 被 激活 ， 数 据 可 从 
IC 主机 数据 寄存 器 (2CMDR ) 中 读 出 。 在 2C 模块 以 主 接收 器 模式 工作 时 ，ACK 位 通常 
被 置 位 ， 让 DC 总 线 控制 器 在 每 个 字 节 接收 完成 后 自动 发 出 一 个 应 答 信 号 。 在 DC 总线 控制 
器 无 需 接收 从 发 送 器 发 送 的 数据 时 ， 该 位 须 清 零 。 

在 此 模块 以 从 机 模式 工作 时 ，I2C 从 机 原始 中 断 状 寄存 器 态 (I2CSRIS) 中 的 两 位 用 来 
监测 总 线 上 的 开始 和 停止 条 件 ; 而 2C 从 机 屏蔽 中 断 状态 寄存 器 (12CSMIS) 中 的 两 位 将 
STARTRIS 与 STOPRIS 位 转变 成 控制 器 中 断 (当中 断 功 能 已 使 能 ) 。 

(2) 带 7 位 地 址 的 数据 格式 

在 满足 开始 条 件 之 后 ， 将 发 送 从 机 地 址 。 该 地 址 长 度 为 7 位 , 第 8 位 是 数据 方向 位 
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(12CMSA 寄存 器 中 的 R/S 位 ) 。 如 果 R/S 位 被 清 零 ， 则 表示 发 送 操作 ; 如 果 被 置 位 ， 则 表 
示 接 收 操作 。 数 据 传送 由 主机 产生 的 停止 条 件 终止 。 但 是 ， 主 机 无 需 首 先 产生 停止 条 件 即 可 
与 总 线 上 的 其 他 设备 通信 。 因 此 ， 在 单 次 传输 中 可 以 存在 多 种 接收 /发 送 格式 组 合 ， 如 
图 8-4 所 示 。 


1 2 1 ミッ 1 
TAX rss 人 KmsNAck ア MssX  、 XssmNack /Tr 








从 机 ”地址 | 
图 8-4 7 位 地 址 的 完整 数据 传输 


第 一 字 节 中 的 前 7 位 即 构成 从 机 地 址 (如 图 8-5 所 示 ) 。 第 8 位 确定 报 文 的 方向 。 若 第 
一 字 节 中 的 R/S 位 为 零 ， 则 表示 主机 向 选 定 的 从 机 发 送 数据 ， 该 位 为 1 则 表示 主机 接收 从 
机 发 送 的 数据 。 

(3) 数据 有 效 性 

SDA 线 上 的 数据 在 时 钟 的 高 电 平 期 间 必须 稳定 ， 只 有 在 SCL 为 低 电 平时 ， 数 据 线 才能 
改变 ， 如 图 8-6 所 示 。 


Be 从 机 地 址 一 | 
图 8-5 第 一 字 节 中 的 R/S 位 图 8-6 I2C 总 线 位 传输 过 程 中 的 数据 有 效 性 


(4) 应 答 

所 有 的 总 线 传 输 都 包含 一 个 由 主机 产生 的 应 答 时 钟 周 期 。 在 应 答 周 期 中 ， 发 送 器 ( 主 
机 或 者 从 机 ) 会 释放 SDA 线 。 在 应 答 时 钟 周期 内 ， 接 收 器 必须 将 SDA 拉 低 。 且 在 应 答 周期 
内 ， 接 收 器 发 出 的 数据 必须 遵循 数据 有 效 性 要 求 。 

如 果 从 机 接收 器 不 应 答 从 机 地 址 ， 从 机 必须 将 SDA 保持 在 高 电 平 ， 以 使 主机 产生 停止 
条 件 并 终止 当前 的 传输 。 如 果 主 机 设备 作为 接收 器 ， 那 么 它 需 要 应 答 每 一 个 由 从 机 发 起 的 数 
据 传输 。 由 于 主机 控制 传输 中 的 字 节 数 ， 通 过 不 应 管 最 后 一 个 字 节 ， 主 机 将 数据 的 末尾 告知 
从 机 发 送 器 指示 数据 的 结束 。 接 下 来 从 机 发 送 器 必须 释放 SDA， 以 便 让 主机 产生 停止 条 件 
或 者 重复 的 开始 条 件 。 

(5) 仲裁 

只 有 在 总 线 空闲 时 ， 主 机 才 可 以 开始 传输 。 在 开始 条 件 的 最 小 保持 时 间 内 ， 可 能 会 有 两 
个 或 者 更 多 的 主机 产生 开始 条 件 。 在 这 些 情况 下 ， 当 SCL 为 高 电 平 时 ，SDA 线 上 将 产生 仲 
裁 机 制 。 在 仲裁 过 程 中 ， 第 一 个 竞争 的 主机 在 SDA 上 设置 “1” (高 电 平 ) ， 而 另 一 个 主机 
发 送 “0”( 低 电 平 )， 则 发 送 “1” 的 这 个 主机 将 关闭 其 数据 输出 阶段 并 退出 ， 直 至 总 线 再 
次 空闲 。 
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仲裁 可 以 在 多 个 位 上 发 生 。 仲 裁 的 第 一 个 阶段 是 比较 地 址 位 ， 若 两 个 主机 试图 寻 址 相同 
的 设备 ， 则 仲裁 继续 比较 数据 位 。 

2. 可 用 的 速度 模式 

DC 总 线 可 以 在 标准 模式 、 快 速 模 式 、 快 速 + 模式 和 高 速 模 式 运 行 。 但 选择 的 模式 应 和 
总 线 上 的 其 他 2C 器 件 的 速度 匹配 。 

(1) 标准 、 快 速 和 快速 + 模式 

选择 标准 、 快 速 和 快速 + 模式， 可 通过 2C 主机 定时 器 周期 寄存 器 (PCMTPR) 得 到 ， 
它们 的 SCL 频率 分 别 为 100 kbit/s 、400 kbit/s 和 1 Mbit/s。 

決定 DC 时 钟 速率 的 参数 如 下 : 
































CLK_PRD // 系 统 时 钟 周期 
SCL_LP //SCL 的 低 电 平 相 位 (固定 为 6) 
SCL_HP //SCL 的 高 电 平 相位 (固定 为 4) 

















TIMER_PRD //I2CMTPR 寄存 器 的 编程 值 


DPC 时 钟 周 期 计算 公式 如 下 ; 
SCL_PERIOD =2 x (1 + TIMER_PRD) x(SCL_LP+SCL_HP) xCLK_PRD 
(2) 高 速 模式 
TM4C123GH6PM 的 外 设 2C 支持 主 从 高 速 运行 模式 ， 可 通过 将 2C 主机 控制 /状态 寄存 
器 (2CMCS) 中 的 HS 位 置 位 来 配置 高 速 模式 。 它 以 66. 6%733. 3% 占 空 比 的 高 位 速率 进行 
数据 传输 ， 但 通信 和 仲裁 取决 于 用 户 所 选择 的 标准 ， 即 快速 模式 和 快速 + 模式 的 速度 。 当 
2CMCS 寄存 器 中 的 HS 位 被 置 位 时 ， 当 前 模式 的 上 拉 电 阻 将 被 使 能 。 
可 使 用 下 面 的 公式 来 选择 时 钟 周 期 ， 这 里 SCL_LP =2、SCL_HP = 1。 
SCL_PERIOD =2 x (1 + TIMER_PRD) x(SCL_LP+SCL_HP) xCLK_PRD 
当主 机 操作 时 ， 高 速 模式 的 数据 格式 如 图 8-7 所 示 。 


RIW 
特定 器 件 NAK 地 址 | 


| 标准 (100kHz) 或 快速 模式 (400kHz) ーー | 高速 _ | 


(3.3Mbit/s) 

















SDA 


图 8-7 高速 模式 的 数 据 格 式 


3. 中 断 

DC 将 在 以 下 条 件 时 产生 中 断 : 
① 主机 通信 完成 。 

② 主机 仲裁 失败 。 

③ 主机 通信 和 错误。 

④ 主机 总 线 超时 。 

@) 从 机 通信 接收 。 

⑥ 从 机 通信 请 求 。 
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⑦ 监测 到 总 线 上 发 生 停止 条 件 。 

⑧ 监测 到 总 线 上 发 生 开始 条 件 。 

PC 主机 和 ZC 从 机 模块 具有 单独 的 中 断 信 号 。 人 尽管 在 许多 条 件 下 两 个 模块 都 可 以 产生 
中 断 ， 但 是 最 后 只 有 一 个 中 断 信 号 将 被 发 送 到 中 断 控制 器 。 

(1) DC 主机 中 断 

当 通 信 结 束 (发 送 、 接 收 )、 仲 裁 失 败 或 者 通信 发 生 错 误 等 时 ，I2C 主机 模块 都 会 产生 
一 个 中 断 ， 可 通过 将 DPCMIMR 寄存 器 中 的 IM 位 置 位 来 使 能 2C 主机 中 断 。 当 满足 中 断 条 
件 时 ， 必 须 通 过 软件 检查 2C 主机 控制 /状态 寄存 器 (I2CMCS) 中 的 ERROR 和 ARBLST 
位 ， 以 验证 错误 并 未 发 生 在 最 后 一 个 通信 期 间 ， 并 且 确 保 没 有 丢掉 仲裁 。 如 果 最 后 一 个 通信 
没有 得 到 从 机 的 应 答 ， 那 么 就 会 发 生 错误 。 如 果 没 有 错误 发 生 ， 而 且 主 机 也 没有 丢失 仲裁 ， 
那么 应 用 程序 将 继续 进行 数据 传输 。 当 I2C 主机 中 断 清除 寄存 器 (I2CMICR) 中 的 IC 位 置 
位 时 ， 就 可 清除 该 中 断 。 

如 果 应 用 程序 无 需 使 用 中 断 ， 则 可 通过 2C 主机 原始 中 断 状 态 寄存 器 (I2CMRIS) 随时 
查看 原始 中 断 状 态 。 

(2) DC 从 机 中 断 

在 已 接收 到 数据 或 请 求 时 ， 从 机 模块 将 会 产生 中 断 。 将 2C 从 机 中 断 屏蔽 寄存 器 
(12CSIMR) 中 的 位 DATAIM 置 位 即 可 使 能 该 中 断 。 通 过 软件 检查 DC 从 机 控制 /状态 寄存 器 
(12CSCSR) 中 的 RREO 和 TREQ 位 ， 就 可 确定 该 模块 应 写 人 (发送) 还 是 读 取 (接收 ) 来 
自 2C 从 机 数据 寄存 器 (I2CSDR ) 中 的 数据 。 如 果 从 机 模块 处 于 接收 模式 ， 且 已 接收 第 一 
个 字 节 ， 那 么 FBR 和 RREQ 位 将 同时 置 位 。 如 果 将 DC 从 机 中 断 清除 寄存 器 (I2CSICR ) 
中 的 DATAIC 位 置 位 即 可 清除 该 中 断 。 

另外 ， 当 监测 到 开始 和 停止 条 件 时 ， 从 机 模块 也 会 产生 中 断 。 可 通过 将 2C 从 机 中 断 屏 
项 寄存 器 (I2CSIMR ) 中 的 STARTIM 和 STOPIM 位 置 位 来 使 能 这 些 中 断 ， 并 可 将 PC 从 机 
中 断 清除 寄存 器 (ICSICR) 中 的 STOPIC 和 STARTIC 位 置 位 来 清除 这 些 中 断 。 

如 果 应 用 程序 无 需 使 用 中 断 ， 则 可 通过 2C 从 机 原始 中 断 状态 寄存 器 (I2CSRIS) 随时 
查看 原始 中 断 状 态 。 

4. 回 送 操作 

将 DC 主机 配置 寄存 器 (2CMCR) 中 的 LPBK 位 置 位 来 让 I2C 模块 进入 内 部 回 送 模式 ， 
以 进行 诊断 或 者 调试 工作 。 在 回 送 模式 下 ， 主 机 和 从 机 发 出 的 SDA 和 SCL 信和 号 被 绑 定 在 一 
起 ， 用 于 在 无 需 使 用 IO 接口 时 也 可 对 器 件 进 行内 部 测试 。 

说 明 : 本 章 没有 介绍 到 的 内 容 请 读者 参考 TM4C123GH6PM 数据 手册 的 2C 部 分 。 





























主机 操作 
一 般 执行 步骤 如 下 : 
(1) I2CMasterInitExpClk( ) 


首先 调用 12CMasterInitExpClk ( ) 来 初始 化 DC 主机 模块 ,设置 总 线 速度 和 使 能 主机 
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模块 。 

(2) 12CMasterSlaveAddrSet( ) 

采用 2CMasterSlayeAddrSet( ) 函数 设置 从 机 地 址 ， 用 于 定义 传输 是 一 次 发 送 (从 主机 写 
数据 到 从 机 ) 还 是 一 次 接收 〈 从 主机 读 取 从 机 的 数据 ) 。 

(3) LDCMasterBusBusy( ) 

如 果 连 接 到 一 个 含有 多 个 主机 的 2C 总 线 上 ，Tiva I2C 主机 必须 在 尝试 启动 传输 前 ， 先 
行 调用 2CMasterBusBusy( ) 来 确定 是 否 处 于 忙 状态 。 

(4) I2CMasterDataPut( ) 

在 确定 总 线 处 于 非 忙碌 状态 之 后 ， 可 调用 DPCMasterDataPut( ) 函数 来 发 送 数据 。 

(5) PCMasterControl 

在 完成 以 上 步骤 后 ， 可 调用 PCMasterControl( ) 函数 的 以 下 任 一 命令 来 启动 总 线 上 的 数 
据 传 输 : 

① 12C_MASTER_CMD_SINGLE_SEND。 

② 12C_MASTER_CMD_SINGLE_RECEIVE。 

③ 12C_MASTER_CMD_BURST_SEND_START。 

(④ 12C_MASTER_CMD_BURST_RECEIVE_START。 

这 些 命令 将 会 引起 总 线 的 主机 仲裁 、 驱 动 起 始 序列 、 发 送 从 机 地 址 与 方向 位 。 然 后 ， 其 
余 的 传输 用 轮 询 或 中 断 的 方式 进行 。 

(6) I2CMasterErr( ) 

对 于 一 次 发 送 和 接收 的 情况 ， 轮 询 方式 包括 从 DCMasterBusy( ) 返回 的 循环 。 一 旦 这 个 
函数 指示 12C 主机 不 再 处 于 忙碌 状态 ， 则 说 明 总 线 传输 已 经 完成 ， 此 时 可 用 PCMasterErr( ) 
来 检查 错误 ， 以 确定 数据 是 否 发 送 完 成 或 已 准备 好 。 

(7) 12CMasterDataGet( ) 

如 果 没 有 错误 ， 则 说 明 数 据 发 送 完 成 或 已 经 准备 好 ， 这 时 可 用 I2CMasterDataCet( ) 函数 
来 读 取 数 据 。 

另外 ， 对 于 罕 发 数据 发 送 和 接收 的 情况 ， 每 发 送 与 接收 完 一 个 字 节 ， 或 发 送 或 接收 完 最 
后 一 个 字 节 ， 轮 询 方式 都 会 调用 I2CMasterControl( ) 函数 。 如 果 在 突 发 传输 中 检测 到 错误 ， 
则 可 使 用 停止 命令 来 调用 PCMasterControl( ) 函数 。 

对 于 中 断 传输 ， 则 需 注 册 一 个 2C 器 件 的 中 断 处 理 程序 并 使 能 PC 主机 中 断 ， 使 之 在 主 
机 不 再 忙碌 时 产生 中 断 。 


从 机 操作 


当 采 用 API 来 驱动 2C 从 机 模块 时 ， 首 先 需 调用 2CSlaveInit( ) 来 初始 化 2C 从 机 模块 ， 
以 便 使 能 DPC 从 机 模块 和 初始 化 从 机 的 地 址 。 在 初始 化 完成 后 ， 可 调用 I2CSlaveStatus( ) 以 
轮 询 从 机 状态 ， 确 认 主 机 是 否 请 求 了 发 送 或 接收 操作 。 并 根据 请 求 操 作 的 类 型 ， 调 用 
ICSlaveDataPut( ) 或 2CSlayeDataGet( ) 完 成 传输 。 或 2C 从 机 采用 ZCIntRegister 注册 的 一 个 
中 断 处 理 程序 、 使 能 2C 从 机 中 断 来 处 理 传输 。 
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I2C 固件 库 描述 


DPC API 被 分 为 三 个 函数 组 : 

① 中 断 处 理 。 

② 状态 和 初始 化 处 理 。 

@) 发 送 和 接收 数据 处 理 。 

详细 的 2C 固件 库 函 数 功 能 介绍 请 参考 书后 附录 下 。 


主 从 回环 例 程 


为 了 便于 读者 利用 EK - TM4C123GXL 开发 板 来 测试 2C 的 程序 ， 本 小 节 将 以 开 的 ZPC 
回环 例 程 为 蓝本 ， 介 绍 基于 固件 的 2C 的 编程 与 测试 方法 。 


1) 主 从 回环 例 程 连 线 图 如 图 8-8 所 示 。 

HHH_ 
[pm3/+2co 
[PB1/USBOVBUS 
5| ] FBO/VSBOID 
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UART 外 设 









































PA0/UORxl 
PA1/UOTx 
PEA2/SSTOC1k[ | | 19 
PA3/8810Fgg 
BA4/88TOR 
PA5/88TOT 
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E 从 回环 例 程 连 线 图 








2) 12C 回环 程序 的 功能 说 明 。 


// ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ネ ポ ポポ ネネ ポポ ポポ ポポ ポポ ネ ポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ネネ 
// 文 件 名 : master_slave_loopback. c 

// 来 源 .TI 例 程 

//! 功 能 描述 ， 

//1 这 个 例子 介绍 了 如 何在 回环 模式 下 配置 2CO 模块 ,以 及 建立 主机 与 从 机 模块 的 数据 收发 
//! 首 先 设置 从 机 模块 地 址 以 便 读 取 主 机 发 送 的 数据 

// 1! 然后 将 接收 到 的 数据 与 发 送 的 数据 进行 对 比 ,以 确保 收 到 的 数据 和 发 送 的 数据 相同 
//1 该 示例 采用 轮 询 方法 来 发 送 和 接收 数据 

//! 注 意 :在 回环 模式 下 ,主机 与 从 机 的 数据 线 和 时 钟 线 在 内 部 连接 在 一 起 

//! 本 例 使用 的 外 役 和 IO 端口 如 下 : 

//1 -12CO 外 设 

//1 -GPIO B 端 口 (2CO 引 脚 ) 





























143 


144 


//! - 12COSCL:PB2 
//! - 12C0SDA:PB3 

//! 配 置 下 面 的 UART 依 号 似 作 品 示 例 程 的 控 制 台 信息 之 用 : 
//1 - UARTO 外 设 

//1 - CPIO A 端口 (UARTO 引 脚 ) 

//! - UARTORX :PAO 

//! - UARTOTX :PA1 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 






































#include < stdbool. h > 
#include < stdint. h > 

#include "inc/hw_i2c. h" 
#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/ gpio. h" 
#include " driverlib/i2c. h" 
#include " driverlib/pin_map. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/uart. hy" 
#include " utils/uartstdio. h" 


// ネネ ポポ ホネ ネネ ポポ ネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ボネ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ネネ ポポ ネネ 
8 了 a 

// 要 发 送 的 DC 数据 包 的 数量 

// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 


#define NUM_I2C_DATA 8 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
// 设 置 从 机 模块 地 址 

// 带 7 位 地 址 的 发 送 数 据 格 式 : [A6:A5:A4:A3:A2:Al1:A0:RS] 

// 若 RS 位 为 零 , 则 表示 主机 向 选 定 的 从 机 传输 (发送 ) 数 据 , 该 位 为 1 则 表示 主机 接收 从 机 发 送 的 
// 数 据 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 玉 


#define SLAVE_ADDRESS 0x4C 
































ンク た キキ キキ キキ キキ キキ テキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ネ : 
// 初 始 化 控制 台 函 数 
クキ キキ キキ キキ キキ キテ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キネ 3 
void 
InitConsole( void ) 
| 

// 

// 使 能 GPIOA 的 UARTO 引 脚 

// 

SysCHPeripheralPnable( SYSCTL_PERIPH_CPIOA) ; 





/ 
// 配 置 复 用 引 脚 A0 和 Al 为 UARTO 功能 
// 

GPIOPinConfigure( CPIO_PA0_UORX) : 

















GPIOPinConfigure( GPIO_PA1_UOTX) ; 


// 

// 使 能 UARTO 以 便 可 以 配置 时 钟 

// 

SysCLPeripheralEnable( SYSCTL_PERIPH_UARTO ) ; 











// 
// 使 用 内 部 16 MHz 振荡 需 作 为 UART 时 钟 源 
// 


UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 


// 

// 选 择 这 些 引 脚 的 复 用 (UART) 功 能 

// 

GPIOPinTypeUART( GPIO_PORTA_BASE, GPIO_PIN_0 | GPIO_PIN_1); 





// 
// 初 始 化 UART 的 控制 台 IO 
// 


UARTStdioConfig(0,115200 ,16000000) ; 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 
// 疾 DC0 配置 成 主 从 模式 ,并 使 用 回环 模式 使 其 在 内 部 相连 


// まま ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボド ※ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ※ 六 玉 玉 玉 玉 ※ 玉 * 








int 

main( void ) 

| 
uint32_t pui32DataTx[ NUM_I2C_DATA]; 
uint32_t pui32DataRx[ NUM_I2C_DATA]; 
uint32_t ui32Index; 





// 
// 设 置 时 钟 直接 从 外 部 晶振 /振荡 占 运 行 
// 


SysCtlClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_16MHZ) ; 








27 
//12CO 外 设 必须 使 能 后 方 可 使 
// 


SysCtlPeripheralEnable( SYSCTL_PERIPH_12CO ) ; 


// 

// 使 能 PortB 端口 

XA 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOB) ; 
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// 
// 将 引 脚 复 用 端口 B2 和 B3 配置 成 12C0 功能 
2 

GPIOPinConfigure( GPIO_PB2_I2COSCL) ; 
GPIOPinConfigure( GPIO_PB3_I2COSDA) ; 


// 
// 选 择 这 些 引 脚 为 2C 功能 

// 该 功能 也 将 CPIO 引 脚 配置 为 2C 的 操作 引 脚 ,并 将 其 设置 为 开 漏 操 作 的 弱 上 拉 
// 

GPIOPinTypel2C( GPIO_PORTB_BASE, GPIO_PIN_2 | GPIO_PIN_3); 








// 
// 使 能 回环 模式 。 回 环 模式 是 一 个 内 置 功能 ,可 有 效 地 用 于 2C 的 调试 操作 

// 它 在 内 部 连接 PC 主机 和 从 机 终端 ,可 有 效 地 从 主机 发 送 数据 .由 从 机 来 接收 数据 
ん 

HWREC(I2CO_BASE+I2C_0_MCR) | =0x01; 




















// 

// 使 能 和 初始 化 2CO 主 模块 

// 使 用 2CO 模块 的 系统 时 钟 

// 最 后 一 个 参数 是 设置 DC 的 数据 速率 

// 如 果 为 false, 则 数据 速率 设置 为 100 kbit/s; 如 果 为 true, 则 数据 速率 设置 为 400 kbit/s 
// 
12CMasterInitExpClk(12C0_BASE ,SysClClockGet( ) ,false ) : 


ゴ 


























Xp 
// 使 能 2CO 从 机 模块 。 使 能 此 模块 仅 用 于 测试 目的 
// 

12CSlavePnable( 12C0_BASE ) ; 





// 

// 设 置 从 机 地 址 为 SLAVE_ADDRESS。 在 回环 模式 中 , 它 为 发 送 到 CMasterSlaveAddrSet 
// 水 数 的 一 个 任意 7 位 数 (在 上 面 的 宏 中 设置 ) 

// 

2CSlaveInit( PCO_BASE .SLAVE_ADDRESS) ; 











// 
// 告 诉 主机 模块 ,当主 机 与 从 机 通信 时 ,哪个 地 址 可 以 放置 到 总 线 上 。 将 地 址 设置 为 
//SLAVE_ADDRESS( 如 在 从 机 模块 设置 )。 如 果 接 收 参 数 被 设置 为 false, 则 指示 将 启动 2C 
// 主 机 向 从 机 写 人 数据 ;如 果 为 rue, 那 就 指示 12C 主机 启动 读 取 从 机 发 送 来 的 数据 
// 
I2CMasterSlaveAddrSet( I2CO_BASE ,SLAVE_ADDRESS ,false) ; 
























































// 

/设置 品行 控制 台 用 于 显示 消 
// 

InitConsole( ) ; 











证 




















ノ / 








// 显 示例 程 中 的 信息 
// 
UARTprintf(" DPC ”回环 示例 " ) ; 


UARTprintf(" \n “模块 =IDC0" ) ; 
UARTprintf(" \n “模式 = 单 发 送 /接收 " ) ; 
UARTprintf(" \n ”速率 =100kbps\n\n" ) ; 





Hf: 
// 初 始 化 要 发 送 的 数据 
Hf 

pui32DataTx[ 
pui32DataTx[ 
pui32DataTx[ 
pui32DataTx[ 


0o BD — © 


pui32DataTx[ 
pui32DataTx[ 
pui32DataTx[ 
pui32DataTx[ 


只 二 产 驯 








On 


ノ / 
// 初 始 化 接收 缓冲 区 
for( ui32Index =0; ui32Index <NUM_I2C_DATA; ui32Index ++ ) 
| 
pui32DataRx[ ui32Index | =0; 


// 
// 指 示 数 据 的 方向 

// 

UARTprintf(" 主 机 向 从 机 发 送 数 据 \n" ) ; 





// 
//12C 主机 向 从 机 发 送 了 8 个 数据 
// 
for( ui32Index =0; ui32Index <NUM_I2C_DATA: ui32Index ++ ) 
| 
// 
// 显 示 DC0 主机 正在 发 送 的 数据 
// 
UARTprintf(" 发 送 : %6 ... ",pui32DataTx[ ui32Index] ) ; 


// 

// 将 要 发 送 的 数据 放置 到 数据 寄存 器 中 

ノ // 

12CMasterDataPut(12C0_BASE ,puni32DataTx| ui32Index | ) : 
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// 
// 启 动 从 主机 发 送 数 据 

// 

I2CMasterControl( I2C0_BASE, 2C_MASTER_CMD_SINGLE_SEND) ; 








ん 
// 等 待 ,直到 从 机 接收 完成 并 应 答 数 据 

// 

while( ! (I2CSlaveStatus( 2C0_BASE) & 2C_SLAVE_ACT_RREO ) ) 
| 





// 

// 读 取 来 自从 机 发 送 的 数据 

// 

pui32DataRx[ ui32Index ] = I2CSlaveDataGet( 12C0_BASE); 





// 

// 等 待 ,直到 主机 模块 完成 传输 
ノ // 

while( 12CMasterBusy(12C0_BASE ) ) 
| 








// 

// 显 示 从 机 接收 到 的 数据 

// 

UARTprintf(" 接收 ! %& \n" ,pui32DataRx[ ui32Index] ) ; 


// 
// 复 位 接收 缓冲 区 
// 
for( ui32Index =0; ui32Index <NUM_I2C_DATA: ui32Index ++ ) 
| 
pui32DataRx[ ui32Index | =0; 


// 
// 指 示 数 据 的 方向 

// 
UARTprintf(" \n\n 从 机 向 主机 发 送 数 据 \n" ) ; 





// 
// 将 数据 的 方向 变更 为 true, 使 主机 读 取 来 自从 机 发 送 的 数据 
// 

I2CMasterSlaveAddrSet( 12CO_BASE, SLAVE_ADDRESS ,true) ; 


// 


// 做 一 个 空 接收 ,以 确保 不 会 在 第 一 个 接收 到 的 数据 中 存在 无 效 数据 
// 
12CMasterControl(2CO_BASE,I2C_MASTER_CMD_SINCLE_RECEIVE) ; 





// 
// 空 应 答 并 等 待 从 主机 来 的 接收 请 求 , 以 清除 不 应 被 设置 的 任何 标志 
ん 

while( ! (I2CSlaveStatus( 2C0_BASE) & 12C_SLAVE_ACT _TREO) ) 

| 

| 





for( ui32Index =0; ui32Index <NUM_I2C_DATA: ui32Index ++ ) 
| 
// 
// 显 示 ZC0 从 机 模块 正在 发 送 的 数据 
// 
UARTprintf(" 发 送 : %6 ... ",pui32DataTx[ ui32Index] ) ; 


ノ / 

// 将 要 发 送 的 数据 放置 到 数据 寄存 器 中 

ノ / 

12CSlaveDataPut( 12C0_BASE ,pui32DataTx[ ui32Index ] ) : 


/ 
// 告 诉 主机 读 取 数据 
2 
I2CMasterControl(I2C0_BASE ,DPC_MASTER_CMD_SINGLE_RECEIVE ) ; 








ん 
// 等 待 ,直到 从 机 数据 发 送 完成 

ん 

while( !(I2CSlaveStatus( 2C0_BASE) & 12C_SLAVE_ACT_TREO) ) 
| 

| 





// 

// 从 主机 读 取 的 数据 

// 

pui32DataRx[ ui32Index | =2CMasterDataGet(12C0_BASE ) : 


// 

// 显 示 从 机 已 接收 到 的 数据 

// 

UARTprintf(" 接收 ! %t \n" ,pui32DataRx[ ui32Index] ) ; 














// 告 诉 用 户 测试 完成 








149 


UARTprintf(" \n 完成 。\n\n'" ) ; 


2 
// 返 回 无 错误 
// 


return(0); 


| 
3) 在 CCS5. 5 中 创建 master_slave_loopback 工程 ， 如 图 8-9 所 示 。 


r 









wi CCS Edit - master_slave_loopback/master_slave_loopback.c - Code Composer Studio 









File Edit View Navig Scripts Window Help 


rr 








建 的 工程 





























































册 ect Explorer 2 已 レレ ~ 0 |@ TIResource Explorer | 固 master_slave_loopback.c : 
Elmaster slave loopback fiactive -DI 250 InitConsdlety 5 
而 cludes 
p 区 Debug _252 // 
: Emaster slave loopbacK mm // Display the example setup on the cg 






25 // 
、255 UARTprintf( " 12C 回环 示例 "); 
| 256 UARTprintf("\n ”模块 = 12C9"): 

_ Bprintf (2 党 式 Sa 


b 回 tm4c123gh6pm_startup_ccs.c 
b ゆ tm4c123gh6pm.cmd 
| 固 uartstdio.c 





































8-9 创建 的 master_slave_loopback 工程 




























EE Builder | ® Behaviour | 让 Steps 5 Environment | %; Link Order | s Dependencies 
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4 Build 
4 ARM Compiler 
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> ARM Linker 

















> Resource 
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4 Build 

> ARM Compiler 

4 ARM Linker 
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fFile Search Path 
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環 一 


"${SW_ROOT}/driverlib/ccs/Debug/driverlib.lib" 
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到 








8-10 添加 包含 文件 和 库 文件 的 搜索 路 径 





4) 编译 master_slave_loopback 工程 ， 然 后 将 . out 文件 下 载 到 EK - TM4C123GXL 板 中 。 

$) 打开 PuTTY“ 串 口 助手 ”， 程 序 的 运行 及 测试 结果 如 图 8-11 所 示 。 

从 图 8-11 中 可 以 看 到 ， 发 送 的 数据 和 接收 到 的 数据 相同 ， 这 就 验证 了 以 上 程序 的 正 
确 性 。 
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I2C 回环 示例 
模块 = +2co 
单 发 送 /接收 























图 8-11 在 EK-TM4C123GXL 板 中 程序 的 运行 结果 





基于 DC 的 EEPROM 读 写 例 程 
1) 例 程 硬件 连 线 图 如 图 8-12 所 示 。 
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图 8-12 硬件 连 线 图 


2) 编写 2c_example. c 程序 。 


//! 文 件 名 :22c_example. c 

//! 来 源 : 由 实验 室 改编 

//1 功 能 描述 :通过 tm4c123gh6pm 的 硬件 2CO 单元 向 AT24c01(1KB 的 EEPROM ) 中 的 地 址 0x11， 
//1 写 人 “You have learned to use DPC1“ ,然后 再 将 数据 读 出 ,并 显示 在 LCD 屏幕 上 



































757 


752 


























//! 硬 件 接口 :液晶 串 行 通信 ,接口 如 下 : 


//ISDO( MISO ) - PA7: SCK - PA6: SDI( MOSI) - PAS; 
//IDC - PB4; RESET-PES, CS-PE4: 
//! AT24CO1 的 2C 接口 : SCL - PB2, SDA - PB3; 





//! 注 意 : 1. LCD 采用 天 马 微 电子 ”2.2 寸 TFT 液晶 屏 TM022HDH26 ,驱动 芯片 为 ILI9341 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ボボ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


#include < stdint. h > 

#include < stdbool. h > 

#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include "inc/tm4c123gh6pm. hy" 
#include " driverlib/pin_map. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/gpio. h" 
#include " driverlib/i2c. h" 


ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
// 调 用 GPIOPinConfigure( ) 函数 输入 参数 需要 声明 的 文件 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ: 
#define PART_TM4C123CH6PM 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
// 

// 液 晶 驱 动 文件 ,( 与 2C 无 关 ): 

//LCD. h 为 驱动 程序 

//font. h 为 字符 数组 文件 

//Pin_Def h 为 引 脚 配置 程序 

// 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キネ 3 
#include "LCD. h" 

#include "font. h" 

#include " Pin_Def h" 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ネネ ボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ 


//font h 中 数组 声明 (与 DC 无 关 ) 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 





extern uint8_t const image| ] ; 
extern uint8_t const hanzi| 236 ] : 
extern uint8_t const asc2_1608| 1320 ] : 


レク キキ キキ キキ キキ キキ キキ キキ キキ テキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ そそ そそ: 
//I2C 读 写 EEPROM 相关 函数 声明 
ンク キキ キキ キキ キキ キキ キキ キキ キキ テキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ 
#define SLAVE_ADDRESS 0xS0 
12CMasterWriteEPROM( uint8_t * pui8date ,uint8_t ui8SlaveAddress , 

uint8_t ui8SEEPAddress ,uint32_t ui32Count ) ; 
void 12CMasterReadEEPROM( uint8_t * pui8date ,uint8_t ui8SlaveAddress , 

uint8_t ui8EEPAddress ,uint32_t ui32Count ) ; 

uint8_t inputdate[ ] = "12345abc" ;// 待 传输 的 字符 串 


#ifdef DEBUG 

void 

_ error_(char * pcFilename,unsigned long ulLine) 
| 


1 
#endif 


ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ チキ : 
// 主 函数 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ キネ: 
int main( void ) 


} 
( 


ZZ 

// 存 储 从 12C 读 取 数据 的 数组 声明 
// 

uint8_t readdata| 8 | : 


SysCHClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_PLL | SYSCTL_O0SC_MAIN | SYSCTL_XTAL 
_16MHZ) ; 




















// 
//LCD 相关 引 脚 的 配置 函数 ,只 用 PC 时 ,可 删除 
// 


GPIOinit( ) ; 


// 
//LCD 液晶 初始 化 函数 
// 

Led_Init( ) ; 


// 
//LCD 屏幕 清 屏 函 数 
//BACK_COLOR 设置 背景 颜色 
/POINT_COLOR 设置 画笔 颜色 
// 详 情 请 参考 LCD. h 文件 

// 

LCD_Clear( WHITE) ; 
BACK_COLOR = WHITE: 
POINT_COLOR = BLACK; 















































// 

// 在 10.10 坐标 显示 字符 串 " We write to EEPROM:" 
// 

LCD_ShowString( 10,10," We write to EEPROM:" ) ; 


// 
// 在 10.50 坐标 显示 将 传递 的 数据 :"EEPROM" 
// 
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LCD_ShowString( 10,50 ,inputdate ) ; 


Hf 
// 在 10. 90 坐标 显示 字符 串 :"initiating. .." 
// 


LCD_ShowString( 10 ,90 , "initiating. .. " ); 


ノ / 

// 使 能 2CO 模块 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_12CO ) ; 





// 

// 使 能 GPIOB 模块 

//SCL 为 PB2,SDA 为 PB3 

XZ 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOB) ; 





// 
// 设 置 PB2 为 PC 的 SCL 功能 
/7/ 勿 忽略 添加 必要 的 头 文件 
ン 

CPIOPinConfigure( CPIO_PB2_I2COSCL) ; 








ン 
// 设 置 PB3 为 PC 的 SDA 功能 
/7/ 勿 忽略 添加 必要 的 头 文件 
ン 

CPIOPinConfigure( CPIO_PB3_I2COSDA ) ; 








// 
// 进 行 PB3(SDA) 的 引 脚 配置 
// 注 意 :PB3 与 PB2 函数 不 同 , 且 必 须 如 下 设置 

// 

GPIOPinTypel2C( GPIO_PORTB_BASE,GPIO_PIN 3) ; 


























XZ 
// 进 行 PB2( SCL) 的 引 脚 配置 
// 注 意 :PB3 与 PB2 函数 不 同 , 且 必 须 如 下 设置 

// 因 为 SCL 引 脚 与 SDA 不 同 ,不 能 设置 为 开 漏 模式 

XZ 

GPIOPinTypel2CSCL( GPIO_PORTB_BASE, GPIO_PIN_2); 
































で 





XS 

// 配 置 2CO 模块 的 通信 时 钟 ,false 代表 传输 速率 为 100 kbit/s 
//true 代表 速率 为 400 kbit/s 

ノ / 

12CMasterInitExpClk(12C0_BASE ,SysClClockGet( ) ,false ) ; 
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Hf 

// 在 10. 90 坐标 显示 字符 串 :" writing. . . 
ノ / 

LCD_ShowString( 10 ,90 , "writing. . . "りう: 


// 
// 将 数组 inputdata[ ] 的 数据 通过 2C 写 和 人 
//SLAVE_ADDRESS(0x50) 地 址 的 EEPROM 中 

// 写 人 的 寄存 器 地 址 为 0X00, 写 和 人 数据 长 度 为 8 

// 

I2cMasterWriteEEPROM( inputdate, SLAVE_ADDRESS ,0x00 ,8 ) ; 


ノ // 

/ 在 10.90 坐标 显示 字符 串 :" Reading... 
7 

LCD_ShowString(10 ,90," Reading. . . "); 


// 
// 通 过 DC 将 EEPROM 中 数据 写 人 数组 readdata[ ] 

// 从 机 地 址 为 SLAVE_ADDRESS(0x50) 

// 读 取 的 寄存 器 地 址 为 0X00 , 读 取 数据 长 度 为 8 

// 

I2cMasterReadEEPROM( readdata, SLAVE_ADDRESS ,0x00 ,8 ) : 




















シク 4 

// 在 10.90 坐标 显示 字符 串 :"We read from EEPROM:" 
メグ 

LCD_ShowSring( 10 ,90," We read from EEPROM:" ) ; 


ノ // 

// 在 10.130 坐标 显示 读 取 的 数据 
ノ // 

LCD_ShowString( 10 ,130 ,readdata ) ; 





return 0 ; 


// ネネ ネネ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


// 函 数 名 称 :I2CMasterWriteEEPROM 











// 函 数 功能 :将 数据 通过 2CO 模块 写 入 AT24CO1C 的 EEPRom 中 
// 输 入 参数 : 

// * pui8date 需 写 人 的 数据 

// ui8SlaveAddress ”从 机 地 址 

// ui8EEPAddress EEPRom 中 的 存储 地 址 

// ui32Count 要 写 入 的 数据 的 长 度 

// AT24C01 一 次 最 多 可 连续 写 入 8B 


i 
// 输 出 参数 :无 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 


I2cMasterWriteEEPROM( uint8_t * pui8date,uint8_t ui8SlaveAddress, 
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uint8_t ui8EEPAddress ,uint32_t ui32Count ) 





uint32_t DataNumber; // 循 环 变量 
uint32_t MsterCMD ; // 传 输 状 态 暂 存 变量 
// 


// 设 置 主机 模式 下 从 机 的 地 址 为 ni8SlaveAddress 

// 读 写 位 为 写 (false) , 读 (true) 

// 

I2CMasterSlaveAddrSet( 12C0_BASE ,ui8SlaveAddress ,false) ; 








メグ 

// 将 EEPRom 地 址 写 入 发送 寄存 器 

// 

12CMasterDataPut(12C0_BASE ,ui8EEPAddress ) ; 


ン 
// 写 人 EEPRom 存储 地 址 

// 本 质 上 是 主机 发 送 从 机 地 址 并 传输 一 个 字 节 数据 

// 但 不 发 送 DC 结束 标志 

ン 

12CMasterControl( 12C0_BASE,12C_MASTER_CMD_BURST_SEND_START) ; 








// 
// 检 测 总 线 是 否 忙 , 即 等 待 传输 完毕 
// 


while( 12CMasterBusy( LCO_BASE) ) ; 


2 
// 检 测 I2C 传输 是 否 出 错 
// 


while( !(I2CMasterErr( I2C0_BASE) ==12C_MASTER_ERR_NONE) ) ; 


KE 

/人 /进入 数据 发 送 循环 

// 备 注 : 写 入 数据 的 第 一 个 字 节 是 2C 传输 的 第 二 个 字 节 数据 
ノ // 

for( DataNumber =0; DataNumber < ui32Count: DataNumber ++ ) 


| 











if( DataNumber == (ui32Count -1) ) 
| 
// 
// 当 剩 下 一 个 字 节 需要 发 送 时 ,指令 变 为 2C_MASTER_CMD_BURST_SEND_FINISH 
// 
MsterCMD =12C_MASTER_CMD_BURST_SEND_FINISH , 








else 
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// 
// 发 送 的 不 是 最 后 一 个 字 节 

// 指 令 变 为 2C_MASTER_CMD_BURST_SEND_CONT 
// 

MsterCMD =12C_MASTER_CMD_BURST_SEND_CONT, 














// 

// 将 需要 发 送 的 1 个 字 节 数据 写 和 人 2C 发 送 寄 存 器 (MDR ) 
// 

12CMasterDataPut(12C0_BASE , * pui8date ) ; 


// 

// 启 动 数 据 发 送 

// 

12CMasterControl( 12C0_BASE ,MsterCMD ) ; 


// 
// 检 测 总 线 是 否 忙 , 即 等 待 传输 完毕 
// 


while( 12CMasterBusy(12C0_BASE ) ) ; 


/ 
// 检 测 PC 传输 是 否 出 错 
XZ 


while( !(12CMasterErr(12C0_BASE ) ==12C_MASTER_ERR_NONE) ) ; 


/A 

// 指 针 加 1 ,移动 到 下 一 个 需要 发 送 的 字 节 
MA 

pui8date ++ ; 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
// 函 数 名 称 :I2cMasterReadEEPROM 
// 函 数 功 能 :通过 PCO 模块 读 取 AT24CO1C 的 EEPRom 中 的 数据 











// 根据 AT24C01C 要 求 , 要 先 写 人 存储 地 址 ,然后 读 取 数据 
p24 所 以 整个 过 程 需要 先 写 后 读 

// 输 入 参数 : 

// * pui8date 读 出 的 数据 存放 的 指针 变量 

// ui8SlaveAddress 从 机 地 址 

Xp m8EEPAddress EEPRom 中 的 存储 地 址 

// ui32Count 要 读 取 的 数据 的 长 度 

// AT24C01 一 次 最 多 可 连续 读 取 8B 


-人 
// 输 出 参数 :无 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 玉米 米 米 米 米 米 米 玉 


void 12cMasterReadEEPROM( uint8_t * pui8date,uint8_t ui8SlaveAddress, 
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uint8_t ui8EEPAddress ,uint32_t ui32Count ) 











uint32_t DataNumber; // 循 环 变量 

uint32_t MsterCMD: // 传 输 状态 暂 存 变 量 

メグ / 

// 设 置 主机 模式 下 从 机 的 地 址 为 ui8SlaveAddress , 读 写 位 为 写 (false) , 读 (true) 
HF 


12CMasterSlaveAddrSet( I2C0_BASE ,ui8SlaveAddress , false )) ; 


// 

// 将 EEPRom 地 址 写 和 发送 寄存 器 

// 

12CMasterDataPut(12C0_BASE ,ui8EEPAddress ) : 


// 
// 写 人 EEPRom 存储 地 址 

// 本 质 上 是 主机 发 送 从 机 地 址 并 传输 一 个 字 节 数据 

// 此 次 发 送 2C 结束 标志 

// 

I2CMasterControl (12C0_BASE,I2C_MASTER_CMD_SINGLE_SEND); 








// 
// 检 测 总 线 是 否 忙 , 即 等 待 传输 完毕 
// 


while( 12CMasterBusy( LCO_BASE) ) ; 


// 
// 检 测 I2C 传输 是 否 出 错 


while( !(I2CMasterErr( I2C0_BASE) ==12C_MASTER_ERR_NONE) ) ; 


ノ // 

// 设 置 主机 模式 下 从 机 的 地 址 为 ni8SlaveAddress 

// 读 写 位 为 读 (true) 

// 

I2CMasterSlaveAddrSet( I2C0_BASE ,un8 SlaveAddress,true) ; 








// 
// 进 入 数据 接受 循环 
ノ // 
for( DataNumber =0; DataNumber < ui32Count: DataNumber ++ ) 
| 
if(ui32Count ==1) 
| 
ノノ / 
// 如 果 接 受 长 度 只 有 1 全 字 吾 
// 指 令 为 2C_MASTER_CMD_SINGLE_RECEIVE 
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// 
MsterCMD =12C_MASTER_CMD_SINGLE_RECEIVE」 





if( DataNumber ==0 ) 
| 
// 
// 接 收 第 一 个 字 节 
// 指 令 为 2C_MASTER_CMD_BURST_RECEIVE_START 
// 
MsterCMD = 2C_MASTER_CMD_BURST_RECEIVE_START: 








1 
i 


else if( DataNumber == (ui32Count - 1 ) ) 
| 
区 为 
// 接 收 最 后 一 个 字 节 
// 指 令 为 2C_MASTER_CMD_BURST_RECEIVE_FINISH 
// 
MsterCMD = 2C_MASTER_CMD_BURST_RECEIVE_EINISH: 








else 


// 
// 既 不 是 第 一 个 也 不 是 最 后 一 个 字 节 

// 指 令 为 2C_MASTER_CMD_BURST_RECEIVE_CONT 
// 

MsterCMD = 2C_ MASTER_CMD_BURST_RECEIVE_CONT; 











// 

// 开 始 发 送 数 据 

ノ / 

12CMasterControl( 12C0_BASE , MsterCMD ) ; 





// 
// 检 测 总 线 是 否 忙 , 即 等 待 传输 完毕 
// 


while( 12CMasterBusy(12C0_BASE ) ) ; 


// 
// 检 测 I2C 传输 是 否 出 错 
/ 


while( !(I2CMasterErr( 12C0_BASE) ==12C_MASTER_ERR_NONE) ) ; 


// 
// 将 主机 数据 寄存 器 ( MDR ) 中 的 数据 读 出 
/并 存储 到 指定 数组 
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ノ / 
* pui8date =12CMasterDataGet( CO_BASE ) ; 


// 

// 存 储 数据 的 指针 加 1 
ノ / 

pui8date ++ ; 


| 
3) 在 LaunchPad 板子 测试 。 
① 建立 工程 、 编 译 、 下 载 等 ， 过 程 省 略 。 
② 在 如 图 8-13 处 设置 一 个 断 点 〈 即 读 EEPROM 函数 处 ) 。 





re か デー っ 


图 8-13 在读 EEPROM 函数 处 设置 一 个 断 点 























③ 单 击 运行 按钮 ， 在 断 点 处 的 运行 结果 如 图 8-14 所 示 。 





AT24C01 ms 
EEPROM 芯片 二 


四 天 己 TET2.2 
寸 液晶 


We write to EEFROM: 





正在 通过 12C。 
读 EEPROM。 
Reading... 











装 





8-14 在 断 点 〈 读 EEPROM 函数 处 ) 的 运行 结果 
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④ 然后 全 速 运行 ， 读 写 程序 的 运行 结果 如 图 8-15 所 示 。 











图 8-15 通过 12C 模块 写 入 的 数据 和 读 出 的 数据 比较 


从 图 8-15 中 可 以 看 到 ， 写 入 的 数据 和 读 出 的 数据 一 致 ， 验 证 了 上 述 PC 读 写 程序 的 正 
确 性 。 

说 明 : 没有 M4/M3 板 卡 的 读者 可 参考 soft_i2c_atmel 例 程 (配套 资源 第 8 章 给 出 ) ， 将 
芯片 选 为 LM3S316 等 ， 即 可 在 Proteus 中 进行 测试 。 该 程序 TI 写 得 比较 有 特色 ， 它 把 一 些 可 
能 在 读 / 写 中 出 现 的 情况 作为 一 种 状态 ， 并 以 状态 机 的 方式 来 读 / 写 2C_EEPROM 中 的 数据 ， 
值得 读者 借鉴 (与 经 常 在 STM32 或 CS1 单片机 中 使 用 的 写法 有 所 不 同 ) 。 
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o の 第 半 co 
同步 串 行 接口 (SSI ) 


同步 串 行 接口 (Synchronous Serial Interface，SST) 是 一 种 常用 的 工业 通信 接口 ， 由 摩托 
罗拉 公司 发 布 被 多 家 国际 大 公司 采用 。 市 面 上 一 些 流行 的 电子 设备 为 了 减少 信号 线 的 数量 ， 
降低 成 本 多 采用 SPI 接口 ， 比 如 SD 卡 、 液 晶 屏 、CAN 等 。 TM4C123GH6PM 微 控 制 器 包含 4 
个 同步 串 行 接口 (SSI) 模块 。 每 个 SSI 都 可 使 用 主机 或 从 机 接口 与 外 设 进 行 同步 串 行 通信 。 
此 外 ，TM4C123GH6PM 还 支持 飞 思 卡尔 的 SPI 与 MICROWIRE 传输 。 对 于 包含 DMA 控制 器 
的 器 件 ，SSI 模块 提供 了 DMA 接口 以 使 设备 通过 DMA 传输 数据 。 

该 驱动 程序 包含 在 driverlib/ssi.c 中 , driverlib/ssi.h 包含 应 用 程序 使 用 的 API 
定义 。 
本 章 的 主要 内 容 : 


> SSI 模块 
> SSI 固件 库 函 数 ( 见 附 录 G) 
> 例 程 

















SSI 的 特点 


TM4C123GH6PM SSI 单元 的 特点 如 下 : 

1) 提供 可 编程 的 控制 接口 ， 能 与 Freescale 的 SPI 接口 、MICROWIRE 或 TI 的 同步 串 行 
接口 相连 。 

2) 主机 或 从 机 的 工作 模式 。 

3) 可 编程 的 时 钟 位 速率 与 预 分 频 器 。 

4) 独立 的 发 送 FIFO 和 接收 FIFO， 均 为 16 位 宽 和 8 个 单元 深 。 

5) 从 4 ~16 位 可 编程 的 数据 帧 大 小 。 

6) 内 部 环 回 测试 模式 用 于 诊断 /调试 。 

7) 标准 FIFO 中 断 与 传输 结束 中 断 。 

8) 使 用 微 直接 内 存 访问 控制 器 (kDMA) 进行 高 效 数据 传输 .: 

① 独立 的 发 送 和 接收 通道 。 

② 在 接收 FIFO 中 有 数据 时 将 产生 单 次 请 求 ， 当 接收 FIFO 中 包含 4 个 数据 单元 时 会 产 
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生 突 发 请 求 。 
③ 在 发 送 FIFO 中 有 空闲 单元 时 将 产生 单 次 请 求 ; 当 发 送 FIFO 中 包含 4 个 空闲 单元 时 
会 产生 突 发 请 求 。 
模块 框图 
同步 串 行 接口 (SSI) 单元 的 功能 模块 框图 如 图 9-1 所 示 。 
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SSIDMACTL 


P 断 控制 
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控制 /状态 
SS 
发 送 /接收 
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RxFIFO 
8X16 
时 钟 预 分 频 器 
Clock Control 
绎 上 中 
系统 时 钟 SSICC SSICPSR 








识别 寄存 器 


SSIPCelllDO | | SSIPeriphlD0 | | SSIPeriphlD4 
SSIPCelllD1 SSIPeriphID1 | | SSIPeriphlD5 


SSIPCelllD2 | | SSIPeriphlD2 | | SSIPeriphID6 
SSIPCelllD3 SSIPeriphID3 | | SSIPeriph1D7 


图 9-1 SSI 单元 的 功能 模块 框图 





163 


信号 描述 
表 9-1 列 出 了 SSI 模块 的 外 部 信号 ， 并 描述 了 每 个 信号 的 功能 。 


表 9-1 SSI 信号 (64LQFP) 



























































复 用 / ee 
引 脚 名 称 | 引 脚 编号 i 引 脚 类 型 ”缓冲 区 类 型 撒 述 
SSIOCIk 19 PA2(2) LO TTL SSI 模块 0 时 钟 信号 
SSIOFss 20 PA3(2) LO TTL SSI 模块 0 帆 信 号 
SSIORx 21 PA4( 2) I TTL SSI 模 块 0 接收 信号 
SSIOTx 22 PA5(2) 0 TTL SSi 模块 0 发 送信 号 
30 PF2(2) 机 本 
Sc TTL SSI 模块 1 时 钟 信 
SSI1 Clk el pp0(2) 0 SSI 模块 1 时 钟 信号 
31 PF3 (2) に 
SIIFss SS 模块 1 帧 信号 
SSI1Fss 62 pp1(2) LO TTL SSI 模块 1 帧 信和 号 
28 PF0(2) 攻 me 
SS SSI 模块 1 寺 
SSI1Rx 区 pp2(2) I TTL SSI 模块 1 接收 信号 
29 PF1 (2) 可 ER 
SS SSI 模 芯 1 全 
SSI1 Tx 6 PD3(2) 0 TTL SSI 模块 1 发 送信 号 
SSI2CIlk 58 PB4(2) 1/0 TTL SSi 模块 2 时 钟 信号 
SSI2Fss 57 PBS(2) 0 TTL SSI 模块 2 帆 信 号 
SSI2Rx 1 PB6(2) I TTL SSI 模块 2 接收 信和 号 
SSD2 Tx 4 PB7(2) 0 TTL SSI 模块 2 发 送信 号 
SSBCIk 61 PDO(1) LO TTL SSI 模块 3 时 钟 信号 
SSI3Fss 62 PD1(1) 0 TTL SSI 模块 3 帆 信 号 
SSI3Rx 63 PD2(1) I TTL SSI 模块 3 接收 信号 
SSB Tx 64 PD3(1) 0 TTL SSI 模块 3 发 送信 号 























功能 简介 

SSI 对 外 设 接收 的 数据 进行 串 一 并 转换 。CPU 可 访问 数据 、 控 制 与 状态 信息 。 发 送 / 接 
收 通 道 都 内 置 了 FIFO 存储 器 ， 在 发 送 与 接收 模式 下 最 多 可 支持 存储 8 个 16 位 数 。 另 外 ， 
SSI 还 支持 LDMA 接口 ， 它 可 将 发 送 和 接收 FIFO 配置 成 pDMA 模块 的 目的 / 源 地 址 。 

1. 位 速率 的 产生 

SSI 模块 内 置 可 编程 的 位 速率 时 钟 分 频 吉 与 预 分 频 器 来 产生 串 行 输出 时 钟 。SSI 模块 支 
持 2 MHz 及 更 高 的 位 速率 ， 但 最 高 位 速率 由 外 设 决定 。 

串 行 位 速率 由 输入 时 钟 (SysClk) 分 频 后 得 到 。 首 先 ， 使 用 2 ~254 之 间 的 偶数 分 频 值 
CPSDVSR 对 输入 时 钟 进行 分 频 ， 它 可 在 SSI 时 钟 预 分 频 寄 存 器 (SSICPSR) 中 进行 配置 。 
而 后 再 使 用 1 ~256 之 间 的 一 个 数 ( 即 1+SCR) 对 时 钟 进一步 分 频 ， 这 里 的 SCR 在 SSI 控 
制 0 寄存 器 (SSICR0) 中 配置 。 

输出 时 钟 SSIClk 的 频率 定义 如 下 : 

SSIClk = SysClk /( CPSDVSR *(1+SCR) ) 
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注意 : 在 主机 模式 下 ， 系 统 时 钟 必须 至 少 为 SSIClk 的 两 倍 ， 而 SSICIk 不 能 超过 25 MHz。 
在 从 机 模式 下 ， 系 统 时 钟 必须 至 少 为 SSIClk 的 12 倍 ， 而 SSIClk 不 能 超过 6.67 MHz。 

2. FIFO 操作 

(1) 发 送 FIFO 

一 般 发 送 的 FIFO 是 一 组 16 位 宽 、8 单元 深 的 先 人 先 出 缓冲 区 。CPU 通过 写 SSI 数据 
寄存 器 (SSIDR) 将 数据 写 和 发送 FIFO 中 ， 且 数据 在 由 发 送 逻 辑 读 出 之 前 一 直 保 存在 发 送 
缓冲 区 中 。 

当 SSI 配置 为 主机 或 从 机 时 ， 并 行 数 据 将 进行 并 一 串 转换 ， 然 后 在 通过 SSITx 引 脚 发 送 
给 相应 的 从 机 或 主机 之 前 ， 先 将 这 些 数据 写 人 到 发 送 FIFO 中 。 

当 工 作 于 从 机 模式 时 ，SSI 模块 在 每 次 主机 启动 通信 后 才 发 送 数据 。 若 发 送 FIFO 为 空 ， 
则 在 主机 启动 会 话 时 SSI 模块 将 把 发 送 到 FIFO 中 的 最 早 一 个 数据 发 送出 去 。 假 设 从 机 启动 
SSI 模块 时 钟 以 来 ， 写 入 到 发 送 FIFO 中 的 有 效 数 据 不 足 8 位 ， 则 SSI 模块 将 发 送 0。 因 此 ， 
FIFO 中 必须 包含 按照 会 话 要 求 的 有 效 数 据 。SSI 模块 可 以 在 发 送 FIFO 为 空 时 产生 中 断 或 
ル DMA 请 求 。 

(2) 接收 FIFO 

一 般 SSI 接收 FIFO 是 一 组 16 位 宽 、8 单元 深 的 先 人 先 出 缓冲 区 。 从 串 行 接口 接收 到 的 
数据 在 由 CPU 读 出 之 前 一 直 保 存在 缓冲 区 中 ，CPU 通过 读 SSIDR 寄存 器 来 访问 读 人 FIFO 
的 数 据 。 在 SSI 配置 为 主机 或 从 机 时 ， 首 先 将 从 SSIRx 引 脚 接收 到 的 串 行 数据 保存 起 来 ， 然 
后 并 行 加 载 到 相应 的 从 机 或 主机 接收 FIFO 中 。 

3. 中 断 

SSI 将 在 出 现下 列 情况 时 产生 中 断 ; 

① 发 送 FIFO 服务 (发送 FIFO 半 满 或 更 低 ) 。 

② 接收 FIFO 服务 (接收 FIFO 半 满 或 更 高 ) 。 

③ 接收 FIFO 超时 。 

④ 接收 FIFO 溢出。 

⑤ 传输 结 

@ 接收 DMA 传输 完成 。 

@ 发 送 DMA 传输 完成 。 

在 发 送 给 中 断 控 制 器 之 前 ， 所 有 中 断 事件 先进 行 一 次 逻辑 或 操作 ， 因 此 同一 时 刻 不 管 实 
际 发 生 了 多 少 个 SSI 中 断 事 件 , SsI 模块 都 只 向 中 断 控 制 器 发 出 一 个 中 断 请 求 。 将 SSI 中 断 
屏蔽 寄存 器 (SSIIM) 中 相应 的 位 清 零 来 单独 屏蔽 这 4 个 中 断 中 的 一 个 。 将 相应 的 屏蔽 位 置 
位 来 使 能 中 断 。 

SSI 模块 不 仅 提供 组 合 的 中 断 输出 ， 而 且 还 分 别提 供 各 个 中 断 源 的 输出 ， 所 以 在 处 理 中 
斯 时 既 可 采用 全 局 中 断 处 理子 程序 ， 也 可 采用 模块 化 的 设备 驱动 程序 。 动 态 的 发 送 /接收 数 
据 流 中 断 与 静态 的 状态 中 断 相互 独立 ， 便 于 即时 响应 FIFO 触发 深度 进行 读 写 操作 。 若 想 了 
解 独 立 中 断 源 的 状态 ， 可 查询 SSI 原始 中 断 状态 寄存 器 (SSIRIS) 和 SSI 屏蔽 中 断 状态 寄存 
器 (SSIMIS) 。 

接收 FIFO 设 有 32 个 SSIClk 时 钟 周 期 的 超时 周期 ， 只 要 接收 FIFO 从 空 状态 变 为 非 
空 状 态 将 开启 超时 周期 。 关 RXFIFO 在 后 续 的 32 个 时 钟 内 再 次 变 为 空 状 态 ， 才 会 将 其 
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中 止 并 复位 。 则 中 断 服 处 理 程序 应 在 读 取 接收 FIFO 之 后 及 时 将 SSI 中 断 清除 寄存 器 
(SSIICR) 中 的 RTIC 位 置 位 ， 以 清除 接收 FIFO 超时 中 断 。 并 且 该 清除 操作 不 能 太 述 执 
行 ， 否 则 有 可 能 造成 中 断 处 理子 程序 在 中 断 被 清除 之 前 已 返回 ， 以 及 不 必要 地 重复 进 
入 中 断 等 问题 。 

传输 结束 (EOT) 中 断 表示 数据 已 经 传输 完成 。 该 中 断 可 以 用 来 指示 何 时 禁止 SS 模块 
的 时 钟 或 进入 休眠 模式 。 另 外 ， 因 数据 的 发 送 和 接收 是 同时 完成 的 ， 该 中 断 也 可 用 于 实时 指 
示 接 收 FIFO 中 的 数据 已 经 就 绪 ， 无 需 等 待 接收 FIFO 超时 。 

4. 帆 格式 

SSI 的 数据 帧 长 度 从 4 ~6 位 可 编程 ， 并 且 始 终 按 照 高 位 在 前 的 顺序 传输 。 有 三 种 基本 
的 帧 类 型 可 供 选 择 : 

① TI 同步 串 行 。 

② 飞 思 卡 尔 SPI。 

③ MICROWIRE。 

对 于 上 述 三 种 帧 格式 ， 串 行 时 钟 (SSIClk) 在 SSI 空闲 时 保持 非 激 活 状 态 ， 只 有 当 数 据 
的 发 送 或 接收 处 于 激活 状态 时 ，SSICIk 才 可 在 所 设置 的 频率 下 工作 。 利 用 SSIClk 的 空闲 状 
态 可 提供 接收 超时 指示 ， 在 一 个 超时 半期 后 ， 如 果 接 收 FIFO 中 仍 含有 数据 ， 则 会 产生 超时 
指示 。 

对 于 Freescale SPI 和 MICROWIRE 这 两 种 帧 格式 ， 在 串 行 帧 (SSIFss) 引 脚 为 低 电 平时 
有 效 ， 并 在 整个 帧 的 传输 过 程 中 一 直 保 持 有 效 。 

而 对 于 TI 的 同步 串 行 帧 格式 ， 在 发 送 每 个 帧 前 ，SSIFss 引 脚 将 发 出 一 个 以 上 升 沿 开始 
并 持续 一 个 时 钟 周期 的 脉冲 。 在 该 帧 格式 中 ，SSI 和 片 外 从 设备 将 在 SSIClk 的 上 升 沿 驱动 各 
自 的 数据 输出 ， 并 在 下 降 沿 锁 存 另 一 个 器 件 的 数据 。 

与 TI 和 Freescale 的 全 双 工 帧 格式 不 同 ，MICROWIRE 采用 半 双 工 方式 ， 使 用 特殊 的 
主 - 从 传输 技术 。 在 该 模式 中 ， 当 帧 开始 传输 时 将 向 外 设 从 设备 发 送 一 个 8 位 的 控制 报 文 。 
并 且 在 发 送 控 制 字 期 间 不 会 接收 数据 。 当 报 文 发 送 结束 后 ， 外 设 从 设备 将 立即 对 报 文 进行 译 
码 ， 发 送 完 8 位 报 文 的 最 后 一 位 后 ， 在 该 从 设备 需 等 待 1 个 串 行 时 钟 周 期 后 ， 方 可 响应 请 
求 的 数据 应 答 。 返 回 的 数据 长 度 为 4~16 位 ， 使 总 的 帧 长 为 13 ~25 位 。 

(1) TI 的 同步 串 行 帧 格式 

TI 同步 串 行 巾 格式 的 单 次 传输 如 图 9-2 所 示 。 
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图 9-2 TI 同步 串 行 帧 格式 的 单 次 传输 


在 该 模式 中 ， 当 SSI 模块 处 于 空闲 状态 时 ，SSIClk 和 SSIFss 将 被 强制 拉 低 ， 发 送 数据 线 
SSITx 被 置 为 三 态 。 在 发 送 FIFO 的 底部 人 口 含 有 数据 时 ，SSIFss 将 变 为 高 电 平 并 持续 一 个 
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SSIClk 周期 。 使 竺 发送 的 值 从 发 送 FIFO 中 传输 到 发 送 逻 辑 的 串 行 移 位 寄存 器 中 。 在 SSIClk 
时 钟 的 下 一 个 上 升 沿 ， 数 据 帧 的 MSB 位 将 移 位 输出 到 从 SSITx 引 脚 上 。 同 理 ， 接 收 数据 的 
MSB 位 也 由 片 外 串 行 从 设备 移 位 到 SSIRx 引 脚 上 。 

然后 ，SSI 和 片 外 从 设备 在 SSIClk 的 每 一 个 下 降 沿 时 将 数据 位 逐个 移 人 到 各 自 的 串 行 移 
位 器 中 。 在 锁 存 了 LSB 位 后 的 第 一 个 SSIClk 上 升 沿 接收 到 的 数据 从 串 行 移 位 器 传输 到 接收 
FIFO 中 。 

TI 同步 串 行 帧 格式 的 连续 传输 如 图 9-3 所 示 。 
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图 9-3 了 同 步 串 行 帧 格式 的 连续 传输 





(2) Freescale SPI 格式 

Freescale SPI 接口 为 4 线 接口 ， 其 中 SSIFss 信号 用 于 从 设备 选择 。Freescale SPI 格式 的 
主要 特点 是 其 SSIClk 信号 定义 相当 灵活 ， 而 非 激 活 状态 与 相位 可 分 别 通过 SSISCRO 寄存 器 
的 SPO/SPH 位 进行 设置 。 在 操作 SSI 时 需 很 好 地 理解 下 面 两 个 位 的 意义 

① SPO 时 钟 极 性 位 。 在 SPO 时 钟 极 性 控制 位 清 零 时 , 将 在 SSIClk 引 脚 上 产生 稳定 
的 低 电 平 。 如 果 将 SPO 位 置 位 ， 当 未 进行 数据 传输 时 , 会 在 SSIClk 引 脚 上 产生 稳定 的 
高 电 平 。 

② SPH 相位 控制 位 。SPH 相位 控制 位 用 于 选择 捕获 数据 的 时 钟 沿 ， 并 允许 数据 改变 状 
态 。 该 位 的 状态 对 传输 的 首位 影响 最 大 ， RE 藻 
SPH 相位 控制 位 清 零 ， 则 在 第 一 个 时 钟 跳 变 沿 捕 获 数据 。 若 SPH 位 置 位 ， 则 在 第 二 个 跳 变 
沿 捕获 数据 。 

1) SPO =0 &SPH =0 时 的 SPI 帧 格式 。 在 SPO =0 与 SPH =0 时 ，SPI 帧 格式 的 单 次 和 
连续 传输 信号 时 序 如 图 9-4 和 图 9-5 所 示 。 
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图 9-4 SPO=0 及 SPH =0 时 SPI 的 帧 格式 ( 单 次 传输 ) 
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图 9-5 SPO =0 及 SPH =0 时 SPI 的 帧 格式 (连续 传输 ) 


在 该 配置 中 ， 当 SS 处 于 空闲 时 : 

Q) SSIClk 被 强制 变 为 低 电 平 。 

② SSIFss 被 强制 变 为 高 电 平 。 

③ 发 送 数据 线 SSTTx 被 仲裁 强制 变 为 低 电 平 。 

④ 当 SSI 配置 为 主机 时 ， 将 使 能 SSIClk 引 脚 。 

⑤ 当 SS 配置 为 从 机 时 ,将 禁止 SSIClk 引 脚 。 

若 使 能 SSI 模块 ， 且 发 送 FIFO 中 已 填 和 人 有效 数 据 ， 则 在 SSIFss 主机 信号 被 拉 低 时 
开始 传输 ， 使 从 机 数据 传输 到 主机 的 SSIRx 输入 线 上 ， 此 时 也 将 使 能 主机 的 SSITx 引 脚 
输出 。 

在 半 个 SSIClk 周期 后 ， 有 效 的 主机 数据 将 被 传送 到 SSTTx 引 脚 。 一 旦 主机 和 从 机 数据 
设置 就 绪 ， 在 另 半 个 SSIClk 时 钟 周期 后 ，SSIClk 主机 时 钟 引 脚 将 被 拉 高 。 随 后 数据 将 在 时 
钟 信号 的 上 升 沿 被 捕获 ， 而 在 时 钟 信号 的 下 降 沿 进行 传输 。 

对 于 单字 传输 ， 在 数据 字 的 所 有 位 都 被 传输 完 后 ，SSIFss 线 在 捕获 到 最 末 一 位 后 的 一 个 
时 钟 周 期 之 后 将 返回 到 空闲 的 高 电 平 状态 。 

而 在 背靠背 的 连续 传输 过 程 中 ， 必 须 让 SSIFss 信和 号 在 相 邻 两 次 数据 传输 之 间 输 出 高 脉 
冲 ， 由 于 在 SPH 位 为 0 时 ， 从 机 选 通 引 脚 将 锁定 串 行 外 设 寄存 器 中 的 数据 ， 不 允许 对 其 进 
行 修改 。 所 以 主机 必须 在 相 邻 两 次 数据 传输 之 间 拉 高 从 机 的 SSIFss 引 脚 ， 以 使 能 串 行 外 设 
数据 的 写 人 操作 。 在 连续 传输 完成 时 ，SSIFss 引 脚 在 捕获 到 最 末 一 位 之 后 的 一 个 时 钟 周 期 后 
将 返回 到 空闲 状态 。 

2) SPO =0& SPH =1 时 SPI 的 帧 格式 。 在 SPO =0 与 SPH =1 时 ，SPI 帧 格式 的 传输 信 
号 时 序 如 图 9-6 所 示 ， 该 图 涵盖 了 单 次 和 连续 两 种 传输 情况 。 

在 此 配置 中 ， 当 SSI 处 于 空闲 时 : 

① SSIClk 被 强制 变 为 低 电 平 。 

② SSIFss 被 强制 变 为 高 电 平 。 

@) 发 送 数据 线 SSITx 被 仲裁 强制 变 为 低 电 平 。 

④ 当 SSI 配置 为 主机 时 ， 将 使 能 SSIClk 引 脚 。 

⑤ 当 SSI 配 置 为 从 机 时 ， 将 禁止 SSIClk 引 脚 。 

如果 使 能 SSI 并 且 在 发 送 FIFO 中 包含 有 效 数 据 ， 若 SSIFss 主机 信号 被 驱动 为 低 电 平 ， 
将 启动 发 送 操作 ， 同 时 也 将 使 能 主机 SSITx 引 脚 输出 。 当 半 个 SSIClk 时 钟 周 期 之 后 ， 主 机 
和 从 机 的 数据 都 将 在 各 自 的 发 送 线 上 就 绪 ， 并 利用 一 个 上 升 沿 跳 变 来 使 能 SSIClk 时 钟 。 数 
768 

















图 9-6 SPO =0 和 SPH =1 时 SPI 的 帧 格式 
注 : Q 为 未 定义 。 





据 在 SSIClk 时 钟 信 号 的 下 降 沿 被 捕获 ， 而 在 时 钟 信号 的 上 升 沿 进行 传输 。 

对 于 单字 传输 ， 在 所 有 位 被 传输 完 后 ，SSIFss 线 将 在 捕获 到 最 末 一 位 (下降 洛 ) 后 的 
一 个 SSIClk 周期 返回 到 空闲 的 高 电 平 状态 。 

如 果 是 连续 传输 ，SSIFss 引 脚 将 在 连续 数据 字 之 间 保 持 低 电 平 ， 且 连续 传输 的 结束 情况 
与 单字 传输 的 相同 。 

3) SPO =1& SPH =0 时 SPI 的 帧 格式 。 在 SPO =1 与 SPH =0 时 ，Freescale SPI 帆 格 式 
的 单 次 和 连续 传输 信号 时 序 如 图 9-7 和 图 9-8 所 示 。 
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图 9-7 SPO=1 及 SPH =0 时 的 飞 思 卡 尔 SPI 帧 格式 〈 单 次 传输 ) 
注 : Q 未 定义 。 
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图 9-8 SPO=1 及 SPH =0 时 的 飞 思 卡 尔 SPI 帧 格式 (连续 传输 ) 


在 该 格式 配置 下 ， 当 SSI 处 于 空闲 时 : 
① SSInClk 被 强制 拉 高 。 
② SSInFss 被 强制 拉 高 。 
③ 发 送 数据 线 SSITx 被 仲裁 强制 拉 低 。 
169 


④ 当 SSI 配置 为 主机 时 ， 将 使 能 SSIClk 引 脚 。 

⑤ 当 SSI 配置 为 从 机 时 ， 将 禁止 SSIClk 引 脚 。 

如果 SSI 模块 已 使 能 ， 并 且 发 送 FIFO 中 已 包含 有 效 数 据 ， 则 在 SSInFss 主机 信号 被 拉 低 
时 开始 传输 ; 使 从 机 数据 立即 传输 到 主机 的 SSInRx 线 上 ， 同 时 将 使 能 主机 设备 的 SSInTx 输 
出 端口 。 

在 过 去 半 个 周期 之 后 ， 有 效 的 主机 数据 将 传送 到 SSInTx 线 上 。 一 旦 主机 和 从 机 数据 的 
设置 就 绪 ， 再 过 去 半 个 SSInClk 周期 ， 将 使 SSmClk 主机 时 钟 引 脚 变 为 低 电 平 。 即 是 说 数据 
在 每 个 SSInClk 时 钟 的 下 降 沿 被 捕获 ， 而 在 上 升 沿 进行 传输 。 

对 于 单字 传输 ， 在 数据 字 的 所 有 位 传输 完成 之 后 ， 当 SSInFss 引 脚 捕获 到 最 末 1 位 (下 
降 沿 ) 之 后 的 1 个 SSInClk 后 将 返回 其 空闲 的 高 电 平 状态 。 

对 于 背靠背 的 连续 传输 ， 必 须 使 SSInFss 信和 号 在 相 邻 两 次 数据 传输 之 间 输 出 高 脉冲 ， 由 
于 在 SPH 位 清 零 时 ， 从 设备 选 通 引 脚 将 锁 存 串 行 外 设 寄存 器 中 的 数据 ， 不 允许 对 其 修改 。 
故 主 设备 须 在 相 邻 两 次 数据 传输 之 间 拉 高 SSInFss 引 脚 的 电 平 ， 以 使 能 串 行 外 设 数据 的 写 入 
操作 。 当 连续 传输 结束 时 ， 在 SSInFss 引 脚 捕获 到 最 未 1 位 后 的 1 个 SSImClk 周期 返回 到 空 

4) SPO =1& SPH =1 时 SPI 的 帧 格式 。 在 SPO =1 与 SPH =1 时 ， 飞 思 卡 尔 SPI 帧 格式 
的 传输 信号 时 序 如 图 9-9 所 示 ， 该 图 涵盖 了 单 次 和 连续 两 种 传输 情况 。 
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图 9-9 SPO =1 及 SPH =1 时 的 飞 思 卡 尔 SPI 帧 格式 





注 : Q 未 定义 。 


在 该 格式 配置 下 ， 当 SSI 处 于 空闲 时 
① SSInClk 被 强制 拉 高 。 
② SSInFss 被 强制 拉 高 。 
@) 发 送 数 据 线 SSITx 被 仲裁 强制 拉 低 。 
④ 当 SSI 配置 为 主机 时 ， 将 使 能 SSIClk 引 脚 。 
⑤ 当 SSI 配 置 为 从 机 时 ， 将 禁止 SSIClk 引 脚 。 
如果 SSI 已 使 能 并 且 在 发 送 FIFO 中 包含 有 效 的 数据 ， 在 SSInFss 主机 信号 被 驱动 为 低 
电 平 将 启动 发 送 操作 。 同 时 将 使 能 主 设备 的 SSInTx 输出 端口 。 再 过 半 个 SSInClk 周期 后 ， 
主 设备 和 从 设备 的 数据 都 将 在 各 自 的 发 送 线 上 就 绪 ， 并 使 用 下 降 沿 的 跳 变 将 SSmClk 使 能 。 
使 数据 在 每 个 SSInClk 时 钟 信号 的 上 升 沿 被 捕获 ， 而 在 下 降 沿 输出 。 
对 于 单字 传输 ， 当 数据 字 的 所 有 位 传输 完成 后 ， 在 SSInFss 引 脚 捕获 到 最 末 1 位 (上升 
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沿 ) 后 的 1 个 SSInClk 周期 返回 到 空 闪 的 高 电 平 状态 。 

对 于 背靠背 的 连续 传输 ，SSInFss 信号 在 连续 的 数据 传输 过 程 中 将 始终 保持 有 效 ( 低 电 
平 ) ， 直 到 捕获 到 最 后 1 个 字 的 最 未 1 位 (上升 沿 ) 之 后 将 返回 其 空闲 状态 。 

对 于 背靠背 的 连续 ，SSInFss 引 脚 将 在 连续 的 数据 字 之 间 保 持 低 电 平 ， 且 连续 传输 的 结 
束 情况 与 单字 传输 的 相同 。 

5. DMA 操作 

SSI 模块 可 与 pDMA 控制 器 接口 具有 相互 独立 的 发 送 通道 和 接收 通道 。 通 过 SSIDMA 
控制 寄存 器 (SSIDMACTL) 来 使 能 pDMA 操作 。SSI 模块 在 接收 FIFO 或 发 送 FIFO 传输 
数据 时 可 向 接收 或 发 送 通道 发 出 uDMA 请 求 。 对 于 接收 通道 ， 只 要 接收 FIFO 中 存在 数 
据 ， 就 会 发 出 单 次 传输 请 求 。 若 接收 FIFO 中 的 数据 三 4 个 ， 将 会 发 出 多 个 连续 传输 请 求 。 
对 于 发 送 通 道 ， 只 要 发 送 FIFO 中 存在 一 个 空位 ， 就 会 发 出 单 次 传输 请 求 。 如 果 发 送 FIFO 
中 的 空位 4 个 ， 将 会 发 出 多 个 连续 传输 请 求 。kDMA 控制 器 将 根据 uDMA 通道 的 配置 
自动 处 理 单 次 传输 请 求 和 连续 传输 请 求 。 而 在 传输 结束 时 pDMA 控制 器 将 会 自动 触发 
中 断 。 
































寄存 器 映射 


表 9-2 列 出 了 SSI 模 块 中 的 寄存 器 。 其 中 所 列 出 的 地 址 偏 移 量 为 寄存 器 相对 于 SSI 的 基 
址 的 十 六 进 制 增 量 : 

e SSIO : 0x4000. 8000。 

e SSIl : 0x4000.9000。 

e SSI2 : 0x4000. A000。 

e SSI3 : 0x4000. BO00。 

注意 : 

① 配置 这 些 寄存 器 之 前 必须 先 使 能 SSI 模块 时 钟 。 

② 在 SSI 模块 时 钟 使 能 之 后 必须 等 待 3 个 系统 时 钟 的 延迟 ， 方 可 访问 SSI 模块 的 寄 
存 器 。 
@ 在 对 任何 控制 寄存 器 重新 编程 前 ， 必 须 先行 禁止 SSI 。 


表 9-2 SSI 寄存 器 映射 












































偏 移 量 名 称 类 型 复 位 描 。 迷 
0x000 SSICRO R/W 0x0000.0000 SSI 控制 寄存 器 0 
0x004 SSICR1 R/W 0x0000.0000 SSI 控制 寄存 器 1 
Ox008 SSIDR R/W 0x0000. 0000 SSI 数据 寄存 器 
0x00C SSISR RO 0x0000. 0003 SSI 状态 寄存 器 
0x010 SSICPSR R/W 0x0000.0000 SSI 时 钟 预 分 频 寄存 器 
0x014 SSIIM R/W 0x0000.0000 SSI 中 断 屏蔽 寄存 器 
0x018 SSIRIS RO 0x0000. 0008 SSI 原始 中 断 状 态 寄 存 器 
Ox01C SSIMIS RO Ox0000. 0000 SSI 屏蔽 中 断 状 态 寄 存 器 
0x020 SSIICR WIC 0x0000. 0000 SSI 中 断 清除 寄存 器 
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( 续 ) 



























































局 移 量 名 称 类 型 复 位 描 。 迷 
Ox024 SSIDMACTL R/W Ox0000. 0000 SSI DMA 控制 寄存 器 
OxFC8 SSICC R/W 0x0000.0000 SSI 时 钟 配 置 寄 存 器 

OxFDO SSIPeriphID4 RO 0x0000.0000 SSI 外 设 标识 寄存 器 4 
OxFD4 SSIPeriphIDS RO Ox0000.0000 SSI 外 设 标识 寄存 器 5 
OxFD8 SSIPeriphID6 RO 0x0000. 0000 SSI 外 设 标识 寄存 器 6 
OxFDC SSIPeriphID7 RO 0x0000.0000 SSI 外 设 标识 寄存 器 7 
OxFEO SSIPeriphIDO RO 0x0000. 0022 SSI 外 设 标识 寄存 器 0 
OxFE4 SSIPeriphID1 RO Ox0000.0000 SSI 外 设 标识 寄存 器 1 
OxFE8 SSIPeriphID2 RO Ox0000.0018 SSI 外 设 标识 寄存 器 2 
OxFEC SSIPeriphID3 RO Ox0000.0001 SSI 外 设 标识 寄存 器 3 
OxFFO SSIPCellIDO RO 0x0000. 000D SSI PrimeCell 标识 寄存 器 0 
OxFF4 SSIPCellID1 RO 0x0000. 00F0 SSI PrimeCell 标识 寄存 器 1 
OxFF8 SSIPCellID2 RO 0x0000. 0005 SSI PrimeCell 标识 寄存 器 2 
OxFFC SSIPCellID3 RO 0x0000. 00B1 SSI PrimeCell 标识 寄存 器 3 














gO 2 SSI 固 件 座 函 数 
SSI API 被 分 成 若干 函数 组 ， 一 般 包 括 以 下 几 类 : 
① 模块 配置 。 
② 数据 处 理 。 
③ 中 断 管理 。 
④ 函数 更 新 。 

(1) 常用 的 SSI 模块 配置 函数 

® SSIConfigSetExpClk( ) 。 

e SSIEnable( ) 。 

e SSIDisable( ) 。 

e SSIDMAEnable( ) 。 

e SSIDMADisable( ) 。 

e SSIClockSourceGet( ) 。 

e SSIClockSourceSet( ) 。 

(2) 常用 的 数据 处 理 函数 

e SSIDataPut( ) 。 

e SSIDataPutNonBlocking( ) 。 

e SSIDataGet( ) 。 

e SSIDataCetNonBlocking( ) 。 
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(3) 常用 的 中 断 管理 函数 

e SSIIntClear( ) 。 

e SSIIntDisable( ) 。 

e SSIIntEnable( ) 。 

e SSIIntRegister( ) 。 

e SSIIntStatus( ) 。 

e SSIIntUnregister( ) 。 

(4) 函数 更 新 

老 版 本 的 SSIConfig( ) 、SSIDataNonBlockingGet( ) 和 SSIDataNonBlockingPut( ) API 函数 被 
新版 的 SSIConfigSetExpClk( ) 、SSIDataCetNonBlocking( ) 和 SSIDataPutNonBlocking( ) API 滑 数 
所 替代 。 安 已 在 ssi. bh 中 提供 老 版 本 API 到 新 版 API 的 映射 允许 已 存在 的 应 用 程序 链接 和 
运行 在 新 版 APL 上 。 

详细 的 SSI 固件 库 函 数 介绍 请 参考 书后 附录 G。 














本 小 节 将 以 TI 的 例 程 和 网 上 有 关 数 码 管 循环 显示 为 例 来 简要 介绍 SSI 固件 库 的 使 用 
方法 。 

1. 基于 SSI 的 主机 模式 传输 数据 例 程 

1) 例 程 中 用 到 SSIO 和 UARTO 的 引 脚 图 如 图 9-10 所 示 。 


SSI1CIlk 30 PF2 
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SSI1Fss 31 PF3 
[| 


SSIIRx 28 PFO 
le 
64 PD3 


图 9-10 SSI1 引 脚 分 配 图 





2) ssi_master_transdata. c 介绍 6 


// ホホ ホネ ポポ ポポ ホネ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ホ ポポ ポポ ネネ ポポ 
// 文 件 名 .ssi_master_transdata. c 

// 来 源 :TI 例 程 

// 功 能 描述 : 

//! 该 例 将 介绍 如 何 配置 SSI1 作为 主机 SPI 模式 。 并 将 5 个 十 六 进 制 数据 通过 Tx 端口 ( 即 PF1) 
//1 发 送 给 板 载 红色 LED ,以 利用 LaunchPad 开发 板 现 有 的 资源 来 观察 SSI 的 数据 传输 ,同时 把 要 
//! 发 送 的 数据 通过 UART 端口 传送 到 PuTTY 上 显示 

//! 此 例 程 使 用 下 列 外 设 和 1/ 0 信号 : 

//! - SSII 外 设 
//!- GPIOF 端口 (SSI1 引 脚 ) 
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//! - SSI1Clk - PF2 
//! - SSIOFss - PF3 

//! - SSIOTx - PF1 

//! 

/AI 下 列 配置 UART 信号 仅 为 显示 该 例 程 的 控制 台 消 息 : 
//1 -UARTO 外 设 

//! - GPIO A 端口 (UARTO 引 脚 ) 

//! - UARTORX - PAO 

//! - UARTOTX - PA1 





// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


#include < stdbool. h > 
#include < stdint. h > 

#include "inc/hw_memmap. h" 
#include " driverlib/gpio. h" 
#include " driverlib/pin_map. h" 
#include " driverlib/ssi. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/uart. h" 
#include "utils/uartstdio. h" 


// ネネ ネネ ネネ ポポ ネネ ポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


// 发 送 和 接收 的 字 节 数 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 玉 
#define NUM_SSI_DATA 5 


uint8_t pui8DataTx| NUM_SSI_DATA | = {OxFF ,0x00 ,OxF1 ,0x88 ,0x011 ; 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


// 此 函数 设置 UARTO 的 控 1 








判 台 来 显示 该 例 程 运行 时 的 信 


自 


2 かい 





// ネネ ネネ ネネ ポポ ネネ ポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


void 


InitConsole( void ) 


| 


// 

// 使 能 用 于 UARTO 引 脚 功能 的 GPIO 端口 A 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 




















メ / 

// 将 引 脚 复 用 端口 A0 和 Al 配置 为 UARTO 功能 
ノ // 

GPIOPinConfigure( CPIO_PA0_UORX) ; 
CPIOPinConfigure( CPIO_PA1_UOTX) ; 


// 

// 使 能 UARTO 以 便 后 续 配置 时 钟 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 





ノ / 








// 使 用 内 部 16 MHz 振荡 需 作 为 UART 时 钟 源 
// 
UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 


A 
// 选 择 这 些 引 脚 的 ( UART) 复 用 功能 

A 

GPIOPinTypeUART( GPIO_PORTA_BASE, GPIO_PIN_0 | GPIO_PIN_1); 























// 
// 初 始 化 UART 的 控制 台 IO 
// 


UARTStdioConfig(0,115200 ,16000000 ) ; 


// ホホ ポポ ポポ ポポ ホ ポポ ポポ ポポ ポポ ホ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
// 閣 SSI1 配置 成 飞 思 卡尔 (SPI) 的 主机 模式 。 这 个 例子 将 发 送 5B 的 数据 来 点 亮 板 载 红色 LED ,以 
及 把 待 发 送 的 数据 通过 UART 在 PuTTY 上 显示 出 来 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 


int 


























main( void ) 


| 


uint32_t ui32Index; 


// 

// 设 置 时 钟 直 接 从 外 部 晶振 运行 

// 

SysCtlClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN 
SYSCTL_XTAL_16MHZ); 
































// 
// 设 置 串 行 控 制 台 用 于 显示 消息 
x 


InitConsole( ) ; 


// 
// 在 控制 台 上 显示 设置 

// 

UARTprintf(" 通过 SSI 发 送 数据 测试 \n" ) ; 
UARTprintf(" 模式 : SPI\n" ) ; 
UARTprintf(" 打印 十 六 进 制 数据 : \n\n" ) ; 














// 
/SSI 外 设 使 用 时 必须 使 能 
// 


SysCtlPeripheralEnable( SYSCTL_PERIPH_SS11); 


// 
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// 使 能 GPIOF 
ノ / 
SysCLPeripheralPnable( SYSCTL_PERIPH_CPIOF ) ; 


// 

// 将 复 用 引 脚 Fl 、F2 、F3 配置 成 SSI1 功能 
// 

GPIOPinConfigure( CPIO_PF2_SSI1CLK ) ; 
GPIOPinConfigure( CPIO_PF3_SSI1FSS ) ; 
GPIOPinConfigure( CPIO_PF1_SSI1TX ) ; 

































































// 
// 将 GPIO 设置 为 SSI 引 脚 , 且 此 函数 也 可 通过 这 些 引 脚 控制 SSI 硬件 
// 


GPIOPinTypeSSI( CPIO_PORTA_BASE,GPIO_PIN_1 | CPIO PIN_3 | CPIO PIN_2): 




















// 
// 设 置 : SSI ,协议 格式 .工作 模式 .位 速率 及 数据 宽度 

SSI1_BASE - 使用 SSI1 

//SysCtlClockGet( ) -提供 系统 时 钟 

//SSI_FRF_MOTO_MODE_0 -协议 格式 设置 :SPO =0 和 SPH =0 
/SSI_MODE_MASTER -工作 模式 设置 :设置 为 主机 模式 

800 -位 速率 为 800 Hz( 便 于 能 观察 到 红色 LED 闪烁 ) 
//16 -数据 宽度 

// 


SSIConfigSetExpClk ( SSIO_BASE, SysCtlClock Get( ) ,SSL_FRF_MOTO_MODE_0, 
SSI_MODE_MASTER ,800 ,16 ) ; 





// 
// 使 能 SSI1 模块 

グ 

SSIEnable( SSIl_BASE) : 





// 发 送 5B 数据 
// 
While(1 ) 
1 
for( ui32Index =0; ui32Index < NUM_SSI_DATA; ui32Index ++ ) 
| 
// 
// 打 印 正 在 传输 的 数据 
// 
UARTprintf( "0x% x," ,pui8DataTx| ni32Index ] ) : 





// 

// 使 用 “阻塞 ”put 函数 发 送 的 数据 。 在 返回 前 ,这 个 函数 将 一 直 等 待 到 发 
// 送 FIFO 中 有 空间 为 止 。 这 可 确保 要 发 送 的 所 有 数据 能 放 入 到 发 送 FIFO 中 
// 

SSIDataPut( SSI0_BASE ,pui32DataTx| ui32Index | ) : 
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// 
// 等 待 SSIl 发 送 FIFO 中 的 所 有 数据 传输 完成 
// 
while(SSIBusy( SSI1_BASE) ) 

{ 

| 


| 
3) 建立 ssi_master_transdata 工程 、 编 译 工程 、 下 载 到 EK - TM4C123GXL 板 中 的 测试 结 


果 ， 如 图 9-11、 图 9-12 所 示 。 
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9-11 在 EK-TM4C123GXL 板 观 察 到 的 结果 


次 cov7 - PuTTY 世上 器 属 柯 




















图 9-12 在 PuTTY 上 显示 正在 发 送 的 数据 


7ZZ 





从 图 9-11 中 可 以 看 到 ， 红 色 的 LED 不 停 的 闪烁 ,该 LED 正好 连接 到 SSIITX 引 脚 ， 说 
明 有 数据 不 断 地 传递 到 红色 LED ， 验 证 了 程序 实现 了 通过 SSI 的 数据 传输 。 有 条 件 的 读者 可 
以 在 SSILTX 引 脚 处 用 示波器 或 逻辑 分 析 仪 观察 传送 的 数据 内 容 ， 并 可 通过 修改 传输 速率 来 
调节 红色 LED 的 闪烁 频率 。 

为 了 使 没有 EK -TM4C123GXL 板 或 示波器 的 读者 也 能 观察 到 所 传输 数据 的 波形 ， 下 面 
将 修改 ssi_master_transdata. c 程序 ， 以 便 可 以 在 Proteus 虚拟 硬件 上 运行 。 

4) 修改 过 的 ssi_master_transdata. c 如 下 : 


#include < stdint. h > 

#include < stdbool. h > 
#include "ine/hw_memmap. h" 
#include "inc/hw_ssi. h" 
#include "inc/hw_types. h" 
#include " driverlib/ssi. hy" 
#include " driverlib/ gpio. h" 
#include " driverlib/pin_map. h" 
#include " driverlib/ sysctl. h" 


#define NUM_SSI_DATA 5 
const uint8_t pui8DataTx| NUM_SSI_DATA ] = 
|OxFF ,0x00 ,0xOF ,0xO0F, Ox00}; 


int main( void ) 
uint32_t uni32Index : 


SysCHClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_6MHZ) ; 


SysCLPeripheralEnable( SYSCTL_PERIPH_SS1O ) ; 
SysCLPeripheralEnable( SYSCTL_PERIPH_CPIOA) ; 


GPIOPinConfigure( CPIO_PA2_SSIOCLK ) ; 

GPIOPinConfigure( CPIO_PA3_SSIOFSS) ; 

CPIOPinConfigure(CPIO_PA5_SSIOTX) ) ; 

GPIOPinTypeSSI( GPIO_PORTA_BASE,GPIO_PIN_5|GPIO_PIN_ 31GPIO_PIN 2); 





SSIConfigSetExpClk(SSIO_BASE ,SysCtClockGet( ) , SSI_FRF_MOTO_MODE 0,SSI_MODE_MAS- 
TER,3000,16) : 
SSIEnable( SSIO_BASE) ; 





while(1) 
| 
for( ui32Index =0; ui32Index <NUM_SSL DATA; ui32Index ++ ) 


| 


SSIDataPut( SSI0_BASE ,pui8DataTx[ ui32Index ] ) ; 
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while(SSIBusy(SSIO_BASE ) ) 


$) 建立 工程 、 编 译 、 下 载 ( 略 ) 。 
6) 搭建 SS 数据 传输 程序 测试 电路 ， 如 图 9-13 所 示 。 


em | 










PAOIUORX PDOPWM0 
PA1/UOTX PD1PWM1 
PA27SSICLK gp PD2 





图 9-13 SSI 数据 传输 程序 测试 电路 
7) SSI 数据 传输 程序 的 测试 结果 如 图 9-14 所 示 。 
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图 9-14 在 Proteus 中 观察 到 的 数据 测试 波形 和 LED 灯 的 闪烁 


注意 : 在 做 本 实验 时 ， 需 要 安装 SW -DK -LM3S301 - 5961 软件 包 。 该 例 程 的 工程 将 在 
配套 资源 中 给 出 。 
2. 基于 SSI 的 数码 管 循环 显示 例 程 
(1) 测试 电路 图 
基于 SSI 的 数码 管 显示 程序 的 测试 电路 如 图 9-15 所 示 ， 控 制 芯 片 可 选 LM3S3xx 的 任意 
179 














一 款 均 可 o 


PAO/UORX PDO/PWMO 
PA1/UOTX PD1/PWM1 
PA2/SSICLK PD2 
PA3/SSIFSS PD3 
PA4/SSIRX PD4 
PA5/SSITX PD5/CCP2 
PBO/CCP0 PD6/FAULT 
PB1 PD7/COo 
PB2 PE0 
PB3 PE1 
PB4C0- 

PB5C1- ADC0 
PB6/CO+ ADC1 
PB7TRST ADC2 
PCO/TCKISWCLK ADC3 
PC17TMS/SWDIO 

PC27TDI 

PC37TDOSWO 





SSICLK 
SSIFSS 











11 SSICLK 
14 SSITX 


PC4 LDO 
PC5C1tC1o RST 
PC6 0SC0 
PC7 OSC1 


74HC595 


LMS3S301 


图 9-15 ”SSI 数码 管 程序 的 测试 电路 


(2) 基于 SSI 的 数码 管 显 示 程 序 


// 文 件 名 :ssi_digital_tube. c 

// 来 源 : 由 实验 室 根据 TI 例 程 及 网 络 改编 

// 功 能 :利用 SSI 模块 在 数码 管 上 动态 显示 0 ~A 
// 供 无 实际 M4 板 卡 的 读者 测试 SSI 模块 代码 之 用 
































#include "inc/hw_ints. h" 
#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/ debug. h" 
#include " driverlib/gpio. h" 
#include " driverlib/interrupt. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/ssi. h" 


//0 ~A 的 编码 
unsigned char Digital_code| 11 | = 10xCO ,0xF9 ,0xA4 ,0xBO ,0x99 , 
0x92 ,0x82 ,0xF8 ,0x80 ,0x90 ,0x88 1 ;// 共 阳 





//10x3f,0x06,0x5b,0x4f,0x66,0x6d,0x7d,0x07,0x7f,0x6f,0x77// 共 阴 
// 使 用 SSI 模块 动态 显示 数字 编码 


int main( void ) 


| 


unsigned char i =0; 




















// 设 置 LDO 输出 电压 
SysCHLDOSet( SYSCTL LDO 2 35V) ; 
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// 设 置 系统 时 钟 
SysCtlClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_O0SC_MAIN | 
SYSCTL_XTAL_6MHZ) ; 


// 使 能 片 内 SSI 模块 
SysCtlPeripheralEnable( SYSCTL_PERIPH_SSI) ; 


// 使 能 CPIOA 端口 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 














// 使 能 GPIOC 端口 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOC) ; 





// 设 置 GPIOC 端口 上 的 PIN_0 引 脚 为 输出 
CPIODirModeSet( SYSCTL_PERIPH_GPIOC,GPIO_PIN_0,GPIO_DIR_MODE_OUT) ; 














// 设 置 GPIOC 端口 的 PIN_0 引 脚 具有 8mA 的 驱动 ,并 且 弱 上 拉 输 出 
GPIOPadConfigSet( CPIO_PORTC_BASE,CPIO_PIN_0, 
GPIO_STRENGTH 8MA,GPIO_PIN_TYPE_STD_WPU) ; 





// 设 置 SSI 为 主机 模式 0,8 位 数 据 , 波 特 率 100000 





SSIConfigSetExpClk ( SSIO_BASE, SysCtlClockGet( ) ,SSI_FRF_MOTO_MODE 0, 
SSI_MODE_MASTER ,100000 ,8 ) ; 








// 使 能 SSI 
SSIEnable( SSI_BASE ) : 











// 设 置 用 于 SSI 的 引 脚 
GPIOPinTypeSSI( CPIO_PORTA_BASE, 
GPIO_PIN_2 | GPIO_PIN_3 | GPIO_PIN_4 | GPIO_PIN_5) ; 











// 公 共 端 信号 
CPIOPinWrite( CPIO_PORTC_BASE,CPIO_PIN_0, 0x01) ; 





// 在 七 段 数码 管 上 循环 显示 0 ~A 
while( 1 ) 
1 
for(i =0; 1 < 12; 1 十 十 ) 
| 
SSIDataPut( SSI_BASE , Digital_code[ ij] ) ; 
SysCtlDelay( 120 * (SysCtlClockGet( ) / 3000) ) ; 
| 


| 


(3) 创建 ssi_digital_tube 工程 
读者 可 根据 配套 资源 所 给 出 的 SSI 数码 管 程序 ， 按 照 前 述 方法 自行 完成 。 
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(4) 测试 结果 
SSI 数码 管 显示 程序 的 测试 结果 如 图 9-16 所 示 。 
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图 9-16 SSI 的 数码 管 显示 程序 测试 结果 


说 明 : 本 章 例 程 在 配套 资源 的 第 9 章 中 给 出 。 
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内 部 存储 天 


内 部 存储 器 〈JInternal Memory) 是 微 控 系统 中 重要 的 器 件 之 一 ， 系 统 中 所 有 程序 的 运行 
均 是 在 存储 器 中 进行 的 ,因此 存储 器 性 能 的 高 低 对 整个 微 控 系统 至 关 重 要 。 
TM4C123GH6PM 微 控制 器 包含 32 KB 的 位 带 (bit - banded) SRAM、 内 部 ROM、236 KB 内 
存 (Flash) 、2KB 的 EEPROM (为 M4 新 增 功能 ) 。 闪 存 控制 器 提供 了 一 个 友好 的 用 户 界 
面 ， 使 闪存 编程 成 为 简单 的 工作 。 闪 存 由 1KB 大 小 独立 可 擦 除 的 块 组 成 ， 并 以 2KB 大 小 的 
块 为 单位 应 用 存储 器 保护 。EEPROM 模块 提供 了 良好 定义 的 寄存 器 接口 ， 以 支持 随机 读 取 
或 写 人 EEPROM， 以 及 支持 轮 询 或 顺序 访问 EEPROM 的 机 制 。 密 码 模型 允许 应 用 程序 锁定 
一 个 或 多 个 EEPROM 块 来 控制 访问 16 字 边 界 。 


本 章 的 主要 内 容 : 


> 内 部 存储 器 单元 简介 

SRAM 

> ROM 

> 闪存 

> EEPROM 

> 内 部 存储 器 固件 库 函 数 ( 见 附录 H) 
上 > 例 程 











模块 框图 与 控制 多 得 


图 10-1 给 出 了 SRAM、ROM、 闪 存 的 模块 框图 和 控制 逻辑 (其 中 点 画 线 框 表 示 位 于 系 
统 控制 模块 中 的 寄存 器 ) 。 
图 10-2 给 出 了 EEPROM 的 模块 框图 和 控制 逻辑 ， 这 里 EEPROM 块 连接 到 AHB 











功能 简介 
本 小 节 将 介绍 SRAM 、ROM 、 内 存 和 EEPROM 存储 器 的 功能 。 
注意 : kDMA 控制 器 可 以 传送 和 接收 片上 SRAM 中 的 数据 。 由 于 闪存 和 ROM 位 于 单独 
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图 10-1 内 部 存储 器 模块 框图 与 控制 逻辑 
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的 内 部 总 线 ，RDMA 控制 器 不 能 从 闪存 或 ROM 来 传送 数据 。 

1. SRAM 

TM4C123CH6PM 器 件 的 内 部 SRAM 位 于 器 件 存 储 器 映射 的 地 址 为 0x2000. 0000。 为 了 
减少 耗费 在 读 - 修改 - 写 中 的 操作 时 间 ，ARM 处 理 器 提供 了 位 带 (bit - banding) 技术 。 在 
已 使 能 位 带 的 处 理 器 中 ,存储 器 映射 中 的 某 些 区 域 (SRAM 和 外 设 空间 ) 能 够 使 用 地 址 别 
名 ， 在 单个 原子 操作 中 单独 访问 各 个 位 。 位 带 的 基地 址 为 0x2200.0000。 

计算 位 带 别名 的 公式 为 

位 带 别名 = 位 带 基地 址 + ( 字 节 偏 移 量 x32) + (位 编号 x4) 
例如 ， 如 果 欲 修改 地 址 0x2000. 1000 的 第 3 位 ， 则 位 带 别 名 的 计算 为 
0x2200. 0000 + (0x1000 x32) + (3 x4) =0x2202. 000C 

由 计算 出 的 位 带 别 名 ， 对 地 址 0x2202. 000C 执行 的 读 / 写 指令 可 仅 直 接 操作 地 址 

0x2000. 1000 字 节 的 第 3 位 即 可 。 
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EEPROM 控制 


1 | 
图 10-2 EEPROM 的 模块 框图 和 控制 逻辑 




















2. ROM 

TM4C123CH6PM 問 件 的 内 部 ROM 位 于 器 件 存储 器 映射 地 址 Ox0100.0000 处 。 

ROM 包含 以 下 组 件 : 

① TivaWare 引导 加 载 程序 和 向 量 表 。 

② TivaWare 外 设 驱 动 程序 库 (DriverLib ) 。 

③ 高 级 加 密 标准 (AES) 密码 表 。 

④ 循环 元 余 校 验 (CRC) 错误 检测 功能 。 

引导 加 载 程序 是 用 来 作为 初始 化 程序 的 加 载 器 (Flash 为 空 时 ) ， 以 及 初始 化 应 用 程序 
固 件 的 更新 机 制 〈 通 过 回调 引导 加 载 程序 ) 。 应 用 程序 可 以 调用 ROM 中 的 外 设 驱 动 函 数 库 
(API) 来 降低 闪存 操作 的 要 求 ， 并 释放 Flash 存储 器 空间 ， 以 便 实现 其 他 用 途 (例如 ， 应 用 
程序 中 的 附加 功能 ) 。 高 级 加 密 标准 (AES) 是 美国 政府 使 用 的 一 种 公开 定义 的 加 密 标准 。 
循环 元 余 校 验 (CRC) 为 验证 技术 ， 用 于 判断 一 个 数据 块 的 内 容 是 否 与 先前 检验 相同 。 

(1) 引导 加 载 程序 概述 

TivaWare 引导 加 载 程序 用 来 将 代码 下 载 到 闪存 设备 ， 而 不 使 用 调试 接口 。 当 内 核 复位 
时 ， 通 过 使 能 配置 寄存 器 (BOOTCFG) 中 的 A ~H 任意 端口 的 CPIO 信号 ， 使 用 户 有 机 会 让 
内 核 直接 执行 ROM 中 的 引导 加 载 程序 或 闪存 中 的 应 用 程序 。 

在 复位 时 ， 将 按 以 下 顺序 进行 : 

① 读 BOOTCFG 寄存 器 。 若 EN 位 被 清 零 ， 将 执行 ROM 中 的 引导 加 载 程序 。 

@ 在 ROM 的 引导 加 载 程序 中 ， 将 指定 的 CPIO 引 脚 状态 与 指定 的 极 性 进行 比较 。 如 果 
引 脚 状态 符合 指定 的 极 性 ， 则 ROM 将 映射 到 地 址 0x0000. 0000 ， 并 继续 执行 ROM 的 引导 加 
载 程序 。 

@ 若 EN 位 被 置 位 或 引 脚 状态 不 符合 指定 的 极 性 ， 数 据 将 从 地 址 0x0000. 0004 读 取 ， 如 
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果 在 这 个 地 址 的 数据 是 0xFFFF. FFFF， 则 ROM 将 映射 到 地 址 0x0000. 0000， 并 继续 执行 
ROM 的 引导 加 载 程序 。 

④ 如 果 在 地 址 0x0000. 0004 的 数据 值 不 是 OxFFFF. FFFF ， 堆 栈 指针 (SP) 将 从 闪存 的 
地 址 0x0000. 0000 处 加 载 ， 而 程序 计数 器 (PC) 则 从 地 址 0x0000. 0004 处 装载 。 然 后 用 户 应 
用 程序 开始 执行 。 

引导 加 载 程序 使 用 一 个 简单 的 包 接 口 与 设备 进行 同步 通信 。 引 导 加 载 程序 的 速度 由 内 部 
振荡 器 (PIOSC) 的 频率 决定 ， 因 为 它 不 会 使 能 PLL。 其 可 用 于 以 下 的 串 行 接口 : 

① UARTO, 

② SSI0。 

③ IC0。 

由 USB。 

这 里 UARTO 、SSIO 、12CO 接口 使 用 相同 的 数据 格式 和 通信 协议 。 

注意 : 引导 装载 程序 的 Flash 存储 器 驻 留 版 本 也 支持 CAN 。 

(2) TivaWare 的 外 设 驱动 库 

TivaWare 外 设 驱 动 库 包含 driverlib/rom. h 文件 ， 它 帮助 调用 ROM 中 的 外 设 驱 动 库 函 
数 。 每 个 函数 的 详细 描述 请 参考 “TM4C123CH6PM ROM User's Cuide”。 更 多 有 关 调 用 
ROM 函数 和 使 用 driverlib/rom.h 的 详细 信息 ， 请 参考 “SW - TM4C - DRL - UG - 
2.0.1.11577” 中 的 “使 用 ROM”。 当 使 用 不 同 的 Tiva C 系列 设备 时 ， 在 ROM 中 可 能 有 不 
同 的 DriverLib 函数 子 集 ， 提供 的 ge rom_map. h 头 文件 可 增强 其 移植 性 。 

其 他 API 函数 可 用 于 图 形 和 USB 功能 ， 但 不 会 预 装载 到 ROM 中 。TivaWare 图 形 库 提 
供 了 一 组 用 于 基本 图 形 设置 和 小 工具 设置 ， 为 基于 Tiva C 系列 微 控制 器 具有 图 形 显示 功能 
的 开发 板 创建 图 形 用 户 界 面 ， 详 细 的 信息 请 参考 TI 官方 文献 : SW - TM4C - GRL - UG - 
2. 0.1.11577。TivaWare USB 库 是 一 组 数据 类 型 和 水 数 ， 可 用 于 在 装 有 Tiva C 系列 微 处 理 需 
的 开发 板 上 创建 USB 设备 、 主 机 或 OTG 应 用 ， 详 细 的 信息 请 参考 TI 官方 文献 : SW - TM4C 
- USBL - UG -2.0.1.11577。 

(3) 高 级 加 密 标准 (AES) 密码 表 

AES 是 一 种 强大 的 加 密 方法 ， 它 在 硬件 和 软件 方面 都 很 快速 且 便 于 使 用 ， 仅 需 很 少 的 
存储 空间 即 可 。 对 于 可 预先 安排 密 钥 的 应 用 程序 ， 采 用 AES 是 比较 理想 的 。ROM 中 提供 了 
执行 XySSL AES 所 需要 的 四 个 数据 表 : 

① 正 向 的 S - box 替换 表 。 

② 反 向 的 S-box 替换 表 。 

③ 正 向 的 多項式 表 。 

④ 反 向 的 多項式 表 。 

(4) 循环 元 余 检 验 (CRC) 错误 检测 

CRC 技术 可 用 来 确认 接收 的 信息 是 否 正确 ， 用 于 确认 解压 后 的 数据 与 验证 Flash 存储 器 
的 内 容 是 否 更 改 ， 以 及 其 他 数据 需要 被 确认 的 情况 。 

3. 闪存 (Flash) 存储 器 

(1) 闪存 存储 器 概述 

闪存 API 提供 了 一 组 用 于 处 理 片上 闪存 的 函数 。 这 些 函 数 用 来 编程 和 擦 除 内 存 、 配 置 闪 
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存 保护 ， 以 及 处 理 闪 存 中 断 。 

当 系 统 的 时 钟 速度 为 40 MHz 或 以 下 时 ，Flash 存储 器 是 单 周 期 读 取 的 。 闪 存 是 一 系列 
大 小 为 1 KB 可 被 单独 擦 除 块 的 集合 。 擦 除 一 个 块 会 使 该 块 的 内 容重 置 为 全 1。 这些 块 可 
配对 成 一 组 可 被 单独 保护 的 2 KB 块 的 集合 ， 且 可 标记 为 只 读 或 只 执行 ， 并 提供 不 同 级 别 
的 代码 保护 。 只 读 块 不 能 被 擦 除 或 者 编程 ， 以 防止 这 些 块 的 内 容 被 修改 。 只 执行 块 同样 
不 能 被 擦 除 或 者 编程 ， 并 且 只 能 由 控制 器 指令 机 制 读 取 ， 以 防止 这 些 块 的 内 容 被 控制 器 
或 调试 器 读 取 。 

(2) 预 取 指 缓冲 器 

闪存 控制 器 有 一 个 预 取 指 缓冲 器 ， 当 CPU 频率 大 于 40 MHz 时 ， 它 会 自动 开启 。 在 该 模 
式 下 ， 闪 存 将 在 二 分 之 一 系统 时 钟 下 工作 。 每 个 时 钟 周期 ， 预 取 指 缓冲 器 将 获取 两 个 32 位 
字 ， 这 样 在 代码 线性 执行 时 取 指 不 会 处 于 等 待 状态 。 取 指 缓冲 器 包含 一 个 分 支 推断 机 制 ， 可 
辨认 出 分 支 ， 从 而 避免 因 读 取 下 一 对 字 而 增加 额外 的 等 待 状态 。 致 使 短 循环 分 支 常常 保留 在 
缓冲 器 中 。 因 此 ， 一 些 分 支 可 无 需 等 待 便 可 执行 ， 而 其 他 分 支 需要 一 个 单独 的 等 待 状态 。 

(3) 闪存 存储 器 保护 

用 户 可 以 在 四 对 32 位 宽 存储 器 中 使 用 两 种 闪存 存储 器 保护 形式 ， 以 2 KB 闪存 存储 器 
块 为 单位 。FMPPEn 和 FMPREn 寄存 器 的 各 个 位 控制 各 种 保护 形式 的 策略 〈 每 个 块 控制 一 
种 策略 ) 。 

① 闪存 存储 器 保护 编程 使 能 寄存 器 (FMPPEn) : 若 某 个 位 被 置 位 ， 就 可 对 相应 的 块 进 
行 编程 ( 写 入 ) 或 擦 除 。 如 果 某 个 位 被 清 零 ， 则 不 能 修改 相应 的 块 。 

② 闪存 存储 器 保护 读 取 使 能 寄存 器 (FMPREn) : 若 某 个 位 被 置 位 ， 则 软件 或 调试 器 就 
可 对 相应 的 块 执行 或 读 取 。 如 果 某 个 位 被 清 零 ， 则 相应 的 块 只 能 被 执行 ， 块 的 内 容 禁 止 被 作 
为 数据 读 取 。 

闪存 存储 器 的 保护 模式 见 表 10-1。 

表 10-1 闪存 存储 器 的 保护 模式 








































































































FMPPEn FMPREn 保护 
0 0 只 执行 保护 。 模 块 只 能 被 执行 ， 不 能 被 写 入 或 擦 除 。 该 模式 用 来 保护 代码 
1 0 模块 既 可 被 写 人 ， 也 可 被 擦 除 或 执行 ,但 不 能 被 读 取 。 该 模式 很 少 使 用 
6 1 只 读 保护 。 模块 既 可 被 读 取 ， 也 可 被 执行 ， 但 不 能 被 写 人 或 乏 除 。 该 模式 用 于 锁定 模块 防 
止 对 其 进行 修改 ， 但 允许 对 其 执行 任意 的 读 或 执行 访问 
1 1 无 保护 。 在 该 模式 下 ， 可 对 模块 进行 写 和 人、 擦 除 、 执 行 或 读 取 





(4) 闪存 编程 

Tiva C 设备 为 内 存 编程 提供 了 一 个 友好 的 用 户 接 口 。 所 有 的 擦 除 / 编 程 操作 都 通过 3 个 
寄存 器 来 处 理 : 闪存 地 址 (FMA) 、 内 存 数 据 (FMD) 和 闪存 控制 (FMC ) 。 

注意 : 如 果 微 控制 器 的 调试 功能 未 被 激活 而 处 于 “ 锁 死 ”状态 ， 必 须 执 行 一 段 恢 复 序 
列 来 激活 调试 模块 。 请 参考 TI 官方 技术 文档 Tiva TM4C123CH6PM Microcontroller DATA 
SHEET 中 的 201 页 有 关 恢 复 锁定 微 控制 器 的 内 容 。 

在 闪存 操作 ( 写 、 页 擦 除 或 整体 擦 除 ) 期 间 ， 禁 止 访问 闪存 。 作 为 结果 ， 指 令 和 按 字 取 
指 将 延迟 到 闪存 操作 完成 。 如 果 在 闪存 操 作 期 间 需 要 执行 指令 ， 则 代码 必须 放置 在 SRAM 
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上 , 井 在 SRAM 上 执行 。 

(5) 中 断 

闪存 控制 器 在 检测 到 下 列 状 态 时 会 产生 中 断 : 

① 编程 中 断 。 当 编程 或 擦 除 动作 完成 时 发 出 的 信号 。 

② 访问 中 断 。 当 对 受 相 应 FMPPEn 位 保护 的 2 KB 块 存储 器 尝试 编程 或 擦 除 操作 时 发 出 
的 信号 。 

能 触发 控制 器 级 中 断 的 事件 在 闪存 控 制 絮 屏蔽 中 断 状态 寄存 器 (FCMIS) 中 定义 ， 将 相 
应 的 MASK 位 置 位 可 使 能 该 中 断 。 若 未 使 用 中 断 ， 则 原始 的 中 断 状态 将 在 闪存 控制 器 原始 
中 断 状态 寄存 器 (FCRIS) 中 可 见 。 

对 闪存 控制 锅 屏 蔽 中 断 的 状态 和 清除 寄存 吉 (FCMISC) 中 相应 的 位 写 1 将 清除 相应 的 
中 断 〈 适 用 于 FCMIS 和 FCRIS 寄存 器 ) 。 

(6) 基本 编程 / 擦 除 操作 

1) 对 1 个 32 位 字 进 行 编程 的 步骤; 

① 閣 源 数 据 写 人 FMD 寄存 器 。 

② 将 目标 地 址 写 和 人 FMA 寄存 器 。 

③ 将 闪存 写 密 钥 和 WRITE 位 的 值 写 入 到 FMC 寄存 器 中 。 根 据 BOOTCFG 寄存 器 中 KEY 
位 的 值 ， 在 进行 内 存 的 写 操作 时 ， 必 须 将 值 0xA442 或 0x71D5 写 入 到 WRKEY 字段 。 

④ 查询 FMC 寄存 器 ， 直 到 WRITE 位 清 零 。 

2) 执行 1 KB 页 探 除 的 步骤 : 

① 将 页 地 址 写 入 到 FMA 寄存 器 中 。 

② 将 闪存 写 密 钥 和 ERASE 位 的 值 写 人 到 FMC 寄存 器 中 。 根 据 BOOTCFG 寄存 器 中 KEY 
位 的 值 ， 在 进行 内 存 的 写 操作 时 ， 必 须 将 值 0xA442 或 0x71D5 写 入 到 WRKEY 字段 。 

③ 查询 FMC 寄存 器 直到 ERASE 位 清 零 ， 或 者 用 FCIM 寄存 器 中 的 PMASK 位 使 能 编程 
中 断 。 

2) 执行 整体 闪存 擦 除 的 步 又 : 

① 将 闪存 写 密 钥 和 MERASE 位 的 值 写 人 到 FMC 寄存 器 中 。 根 据 BOOTCFG 寄存 器 中 
KEY 位 的 值 ， 在 进行 内 存 的 写 操 作 时 ， 必 须 将 值 OxA442 或 0x71D5 写 人 到 WRKEY 字段 。 

② 查询 FMC 寄存 器 直到 MERASE 位 清 零 ， 或 者 用 FCIM 寄存 器 中 的 PMASK 位 来 使 能 
编程 中 断 。 

(7) 32 个 字 的 闪存 写 缓存 器 

32 字 的 写 缓冲 器 提供 了 同时 编程 2 个 32 位 字 的 能 力 ， 可 加 快 闪存 写 访问 的 速度 ， 可 在 
处 理 16 字 的 同时 对 32 字 进 行 编程 ， 需 缓存 的 数据 被 写 入 到 写 缓冲 器 寄存 器 (FWBn) 中 。 

这 些 寄存 器 在 闪存 中 是 以 32 字 对 齐 的 ， 则 FWBO 寄存 器 对 应 FMA 中 的 地 址 (FMA 的 
[6:0] 位 全 为 0)。FWB1 寄存 器 对 应 FMA + 0x4 中 的 地 址 ， 以 此 类 推 。 仅 在 上 次 缓存 的 闪 
存 进行 写 人 操作 后 ， 更 新 过 的 FWBn 寄存 器 方 能 被 写 和 人。 闪存 写 缓冲 器 有 效 寄存 器 (FWB- 
VAL) 显示 了 从 上 次 缓存 闪存 写 操作 后 ， 哪 些 寄存 器 已 被 写 人 。 该 寄存 器 包含 的 位 对 应 32 
个 FWBn 寄存 器 ， 其 中 FWBVAL 的 第 [n] 位 对 应 FWBn。 若 FWBVAL 寄存 器 中 的 某 位 被 置 
位 ， 则 表明 相应 的 FWBn 寄存 器 已 被 更 新 过 了 。 

采用 单独 被 缓冲 的 闪存 写 人 操作 来 编程 32 个 字 的 步 又: 
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① 将 源 数 据 写 人 到 FWBn 寄存 器 中 。 

② 将 目标 地 址 写 人 到 FMA 寄存 器 中 。 该 地 址 必须 为 一 个 32 字 对 齐 的 地 址 ( 即 FMA 的 
[6:0] 位 为 全 0) 。 

@ 将 闪存 写 人 密 钥 和 WRBUF 位 写 入 到 FMC2 寄存 器 中 ( 即 写 入 0xA442. 0001 ) 。 

④ 查询 FMC2 寄存 器 ， 直 到 WRBUF 位 清 零 ， 或 者 等 待 发 出 PMIS 中 断 信号 。 

(8) 非 易 失 性 寄存 器 编程 

下 面 将 讨论 如 何 更 新 闪存 自身 的 寄存 器 。 这 些 寄存 器 存在 于 主 闪存 阵列 之 外 的 单独 空间 
中 ， 它 不 受 擦 除 或 整体 擦 除 的 影响 。 写 操作 可 将 这 些 寄存 咒 中 的 位 由 1 变 0。 除 了 上 电 复 位 
会 将 寄存 器 的 内 容 复 位 为 0xFFFF. FFFF 外 ， 其 他 复位 都 不 会 影响 寄存 器 的 值 。 在 上 电 序列 
后 , 可 用 FMC 寄存 器 中 的 COMT 位 来 提交 确认 寄存 器 的 值 ， 之 后 寄存 器 的 值 将 变 为 非 易 失 
而 保持 下 去 。 在 寄存 器 的 内 容 被 提交 后 ， 能 恢复 出 广 默认 值 的 唯一 方法 就 是 执行 “恢复 一 
个 “锁定 的 ” 微 控 制 器 ”中 描述 的 方法 ( 见 TI 文档 Datasheet - TM4C123GH6PM 的 201 
页 ) 。 

该 驱动 包含 在 driverlib/flash. c 中 , driverlib/fHash. h 包含 API 的 定义 。 

4. EEPROM 

(1) EEPROM 模块 的 特点 

TM4C123GH6PM 微 控制 器 包括 1 个 EEPROM 模块 ， 具 有 以 下 特点 : 

① 可 访问 512 个 32 位 字 的 2 KB 内 存 。 

② 32 全 16 字 的 块 (64 B) 。 

③ 每 个 2 页 面 块 可 进行 500 K ~ 15 M 次 写 操作 。 

④ 每 个 块 的 访问 保护 。 

⑤ 整个 外 设 的 锁定 保护 选项 与 每 个 块 的 锁定 保护 相同 ， 使 用 32 ~96 位 的 解锁 码 。 

⑥ 支持 写 和 完成 后 产生 中 断 ， 以 避免 轮 询 操 作 。 

⑦ 内 置 平衡 擦 写 。 

(2) 功能 简 述 

EEPROM 模块 提供 了 一 个 定义 良好 的 寄存 器 接口 来 支持 随机 读 取 或 写 人 EEPROM， 以 
及 支持 轮 询 或 顺序 访问 EEPROM 的 机 制 。 

一 种 保护 机 制 允 许 锁定 EEPROM 块 ， 以 防止 在 某 些 情况 下 不 必要 的 写 和 人 或 者 读 取 操作 。 
密码 模型 允许 应 用 程序 锁定 一 个 或 多 个 EEPROM 块 来 控制 访问 16 字 边 界 。 

1) 锁定 和 密码 。 可 对 EEPROM 在 模块 级 和 块 级 进行 锁定 。 由 EEPROM 的 密码 寄存 器 
(EEPASSn) 中 的 密码 控制 ， 该 密码 为 一 个 32 ~96 位 之 间 的 值 ， 但 不 可 全 是 1。 其 中 , 块 0 
为 主 块 ,不 仅 用 它 的 密码 可 对 控制 寄存 器 与 其 他 的 块 进行 保护 ， 而 且 也 可 用 块 密码 对 每 个 块 
进行 进一步 的 保护 。 

若 块 0 设 有 密码 ， 则 在 复位 时 整个 模块 都 将 被 锁定 。 其 锁定 规则 : 在 块 0 解锁 以 后 ， 
将 使 块 1~ 块 31 可 访问 ， 而 块 0 会 继续 受 自己 的 保护 位 保护 。 任 何 块 (包括 块 0) 设置 密 
码 后 ， 都 可 以 根据 是 否 锁定 控制 块 来 决定 能 否 被 访问 。 

复位 时 所 有 密码 保护 的 块 均 会 被 锁定 。 欲 解锁 这 些 块 ， 就 必须 将 正确 的 密码 写 人 EEP- 
ROM 解锁 寄存 器 (EEUNLOCK) 中 。 写 人 密码 时 ， 应 通过 EEPASSn 寄存 器 将 其 写 和 人 1 ~ 3 
遍 来 组 成 32 位 、64 位 或 9 位 的 注册 密码 。 在 EEUNLOCK 寄存 器 中 写 和 人 0xFFFF. FFFF 可以 
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重新 锁定 块 或 模块 (0xFFFF. FFFF 为 无 效 密码 ) 。 

2) 保护 与 访问 控制 。 保 护 位 为 每 个 块 提供 了 单独 的 读 写 控制 ， 可 实现 的 保护 模式 
如 下 : 

① 没有 密码 : 任何 时 间 都 可 进行 读 / 写 操作 ， 在 无 密码 时 ， 该 模式 为 默认 。 

② 没有 密码 : 可 以 读 取 ,但 不 能 写 入 。 

③ 有 密码 : 可 读 取 ， 只 有 在 密码 解锁 后 方 可 写 和 人 ， 在 有 密码 时 ， 该 模式 为 默认 。 

④ 有 密码 : 在 锁定 时 只 能 读 取 ， 或 只 能 写 入 。 

⑤ 有 密码 : 在 锁定 时 只 读 ， 但 不 能 写 和 。 

另外 ， 访 问 保护 还 可 以 通过 处 理 器 模式 实现 。 这 种 配置 允许 仅 管理 员 访问 ， 或 管理 
员 与 用 户 访 问 〈 默 认 模 式 ) 。 其 中 ， 仅 管理 员 访 问 模式 还 可 以 阻止 pDMA 与 调试 器 的 
访问 。 

同时 ， 主 块 还 可 以 用 来 控制 保护 机 制 本 身 的 访问 保护 。 若 块 0 的 访问 控制 是 仅 管理 员 访 
问 模式 ， 则 整个 模块 都 可 以 用 管理 员 模 式 访 问 。 并 且 块 0 的 保护 级 别 为 整个 EEPROM 设置 
了 最 低 的 保护 级 别 。 

3) 中 断 控 制 。EEPROM 模块 允许 在 写 入 完成 之 后 发 出 中 断 ， 而 无 需 轮 询 。 该 中 断 可 用 
于 驱动 应 用 程序 的 ISR， 使 ISR 可 写 和 人 更 多 的 字 或 验证 操作 的 完成 。 无 论 是 由 于 错误 还 是 成 
功 编程 或 擦 除 操作 所 引起 ， 该 中 断 机 制 均 可 在 EEDONE 寄存 器 工作 或 停止 时 随时 使 用 。EE- 
PROM 中 断 用 闪存 中 断 向 量 给 内 核发 信号 ， 软 件 可 通过 检测 闪存 控制 器 屏蔽 中 断 状 态 和 清除 
寄存 器 (FCMISC) 的 第 2 位 来 确定 中 断 源 是 否 为 EEPROM。 

4) 工作 原理 。EEPROM 采用 EEPROM 类 型 单元 的 传统 内 存 块 模型 操作 ， 但 使 用 鹿 
区 探 除 。 另 外 ， 若 需要 ， 在 复制 页 中 的 字 时 ， 人 允许 500k + 个 擦 除 周 期 ， 即 每 个 字 均 有 一 
个 最 新 版 本 。 这 样 ， 写 人 操作 就 在 新 的 位 置 创 建 了 一 个 新 版 本 的 字 ， 使 其 原先 的 值 被 
抛弃 。 

每 个 户 区 包含 两 个 块 ， 每 个 块 包含 一 个 活动 副本 和 六 个 元 余 副 本 的 位 置 。 将 密码 、 保 护 
位 和 控制 数据 都 保存 在 页 中 。 当 页 中 保存 最 新 字 的 空间 不 足 时 ， 就 会 启用 一 个 复制 缓冲 区 ， 
使 其 复制 每 个 块 中 的 最 新 字 ， 并 将 原来 的 页 擦 除 ， 最 终 将 复制 缓冲 区 的 内 容 复制 回 页 中 。 这 
种 机 制 可 确保 掉 电 时 的 数据 不 丢失 ， 即 使 在 操作 期 间 。EEPROM 机 制 也 会 跟踪 所 有 的 状态 
信息 ， 提 供 全 面 的 安全 性 和 保护 。 尽 管 几率 很 小 ， 但 在 某 些 环境 下 还 是 可 能 发 生 错 误 ， 比 
如 ， 编 程 过 程 中 电压 过 低 等 。 

EEPROM 详细 的 功能 描述 请 参考 Datasheet - TM4C123CH6PM 的 数据 手册 ( 见 配套 
资源 ) 。 






































闪存 的 API 被 分 成 三 个 函数 组 : 

① 闪存 编程 。 

② 闪存 保护 。 

③ 中 断 处 理 。 

常用 的 一 些 API 函数 列举 如 下 ， 较 详细 功能 介绍 请 见 附 录 H 的 闪存 部 分 。 
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(1) 闪存 编程 

e FlashErase( ) 。 

e FlashProgram( ) 。 

e FlashUsecGet( ) 。 

e FlashUsecSet( ) 。 
(2) 闪存 保护 

e FlashProtectGet( ) 。 
e FlashProtectSet( ) 。 

e FlashProtectSave( ) 。 
(3) 中 断 处 理 

e FlashIntRegister( ) 。 
e FlashIntUnregister( ) 。 
e FlashIntEnable( ) 。 

e FlashIntDisable( ) 。 
e FlashlIntCetStatus( ) 。 
e FlashIntClear( ) 。 


让 部 分 外 设 驱 动 库 保存 到 片上 ROM 中 ， 从 而 可 使 替换 出 的 闪存 空间 用 于 应 用 程序 。 此 
外 ， 引 导 装 载 程序 也 可 存放 在 ROM 中 ， 使 之 被 应 用 程序 调用 来 启动 固件 库 的 更 新 。 

本 小 节 介 绍 的 内 容 如 下 : 

e 直接 ROM 调用 。 

e 映射 ROM 调用 。 

e 固件 升级 。 

较 详 细 功能 介绍 请 见 附 录 H 的 使 用 ROM 部 分 。 


直接 ROM 调用 


(1) 步骤 

① 将 待 运行 应 用 程序 的 器 件 必须 使 用 预 处 理 符 号 定义 ， 该 过 程 可 在 源 代码 或 在 编译 应 
用 程序 的 工程 中 完成 。 如 果 代 码 是 在 工程 之 间 共 享 ， 后 者 将 更 加 灵活 。 

② 头 文件 driverlib/rom. h 中 将 包含 要 调用 ROM 的 源 代码 。 

③ 调用 ROM 外 设 驱 动 库 函 数 的 版 本 。 例 如 ， 如 果 在 ROM 中 调用 CPIODirModeSet( ) 可 
用 ROM_CPIODirModeSet( ) 替代 。 

(2) 定义 (define ) 

用 来 选择 要 使 用 的 设备 ， 因 为 在 ROM 中 的 一 组 可 用 的 函数 集合 必须 有 相应 定制 的 编译 
选项 ; 在 运行 时 的 检查 不 会 提供 任何 闪存 保存 ， 因 为 无 论 是 ROM 调用 还 是 闪存 版 本 的 API 
都 将 在 闪存 映像 中 。 
通过 使 用 ROM_Function( ) ，ROM 将 被 显示 的 调用 。 如 果 讨 论 的 函数 访问 不 在 ROM 中 ， 
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将 产生 一 个 编译 错误 。 
针对 特定 设备 在 ROM 中 提供 的 API 的 详细 信息 ， 请 参阅 TivaWare ROM 用 户 指南 
(spmu349 ) 。 
(3) 样 例 
下 面 是 一 个 在 ROM 中 调用 函数 的 例子 ， 用 #define 在 源 代 码 中 定义 讨论 的 设备 以 蔡 代 工 
程 中 的 文件 : 
#define TARGET_IS_DUSTDEVIL_RAO 
#include " driverlib/rom. h" 
#include " driverlib/ systick. h" 


int 





main( void ) 

| 

ROM_SysTickPeriodSet( 0x1000 ) ; 
ROM_SysTickPnable( ) ; 


ノノ /… 


! 
} 


映射 ROM 调用 


在 工程 之 间 共 享 代码 时 ， 且 一 些 工 程 在 有 ROM 的 设备 上 运行 ， 而 另 一 些 工 程 却 在 没有 
ROM 的 设备 上 运行 ， 方 便 的 做 法 是 使 代码 能 自动 调用 ROM 或 者 闪存 版 本 的 API 酚 数 ， 而 无 
需 在 代码 中 使 用 #ifdef - s。 rom_map. h 提供 了 一 个 访问 ROM 的 自动 映射 特性 。 类 似 rom.h 提 
供 的 ROM_Function( ) API, rom.h 也 提供 一 组 MAP_Function( ) API 函数 。 如 果 函 数 在 ROM 
中 ，MAP_Function( ) 只 需 简 单 地 调用 ROM_Function( ) 即 可 ， 否 则 将 调用 Function( ) 。 

(1) 步骤 

执行 映射 ROM 调用 的 步骤 如 下 : 

① 遵循 以 上 包含 与 使 用 driverlib/rom. h 的 步骤 。 

② 包含 driverlib/rom_map. h。 

③ 继续 上 述 例 程 ， 在 源 编码 中 调用 MAP_GPIODirModeSet( ) 。 

与 直接 调用 ROM 的 方法 类 似 ， 在 编译 时 需 作 出 调用 ROM 还 是 Flash 版 本 的 选择 。 仪 通 
过 ROM 映射 功能 所 提供 的 API 在 ROM 中 可 用 ， 即 其 不 是 在 所 有 的 外 设 API 函数 中 均 可 
使 用 。 

(2) 样 例 

下 面 是 在 共享 代码 中 调用 函数 的 例子 ， 其 中 讨论 的 设备 在 工程 文件 中 定义 : 


#include " driverlib/rom. h" 
#include " driverlib/rom_map. h" 
#include " driverlib/ systick. h" 
void 

SetupSysTick( void ) 

| 

MAP_SysTickPeriodSet( 0x1000) ; 
Map_SysTickEnable( ) ; 
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| 
在 编译 不 含 ROM 设备 时 ， 这 个 例子 等 效 于 : 


#include " driverlib/systick. h" 
void 

SetupSysTick( void ) 

| 

SysTickPeriodSet( Ox1000 ) ; 
SysTickPnable( ) ; 


! 
} 


在 编译 包含 ROM 设备 时 ， 这 个 例子 等 效 于 : 


#include "driverlib/rom. h" 
#include " driverlib/systck. h" 
void 

SetupSysTick( void ) 

| 

ROM_SysTickPeriodSet( 0x1000 ) ; 
ROM_SysTickPnable( ) ; 


! 
} 


ROM 固件 更 新 
ROM 固件 更 新 见 表 10-2 ~ 表 10-4。 


表 10-2 ROM_Update[2C 
功 能 | 从 了 2C0 接口 启动 更 新 








函数 原型 void ROM_Updatel2C( void ) 





























行 。 12CO 从 设备 用 于 数据 传输 ，I2C0 主 设备 用 于 监控 总 线 忙 状态 
返回 参数 无 








描述 通过 2CO 接口 调用 该 函数 开始 一 个 固件 的 更 新 。 此 函数 假设 已 经 配置 好 了 12C0 接口 ， 并 且 目 前 正在 运 
参 

















表 10-3 ROM_UpdateSSI 
功 能 从 SSIO 接口 启动 更 新 





函数 原型 void ROM_UpdateSSI( void) 














描述 通过 SSIO 接口 调用 该 函数 开始 一 个 固件 的 更 新 。 此 函数 假设 已 经 配置 好 了 SSIO 接口 ， 并 且 目 前 正在 
运行 
返回 参数 无 











表 10-4 ROM_UpdateUART 
功 能 从 UARTO 接口 启动 更 新 








函数 原型 void ROM_UpdateUART( void ) 
































描述 通过 UARTO 接口 调用 此 函数 开始 一 个 固件 的 更 新 。 此 函数 假设 已 经 配置 好 了 UARTO 接口 ， 并 且 目 前 正 
“| 在 运行 
返回 参数 无 











193 


(1) EEPROM 概述 

EEPROM API 提供 了 一 组 易于 使 用 片上 非 易 失 数 据 存储 器 “EEPROM” 的 函数 。 该 函数 
用 于 编程 和 擦 除 EEPROM 、 配 置 EEPROM 保护 、 处 理 EEPROM 中 断 。 

可 对 EEPROM 以 逐 字 “逻辑 与 ”的 方式 进行 编程 ， 与 内 存 不 同 ， 在 EEPROM 中 写 一 
新 值 之 前 不 需要 应 用 程序 显 式 地 擦 除 一 个 字 或 页 。 

当 尝 试 一 个 无 效 访问 时 ( 如 读 取 受 保护 的 块 )，EEPROM 控制 器 将 会 发 出 一 个 中 断 。 

个 中 断 可 被 用 来 验证 编程 操作 ， 以 防止 自动 忽略 无 效 访问 ， 从 而 隐藏 潜在 的 bug。 > 
个 擦 除 或 编程 操作 完成 时 ， 将 会 产生 中 断 。 

可 用 的 EEPROM 大 小 和 它 包含 的 块 数 目 在 Tiva 家 族 的 不 同 成 员 之 间 是 有 差异 的 。 用 也 
数 EEPROMSizeGet( ) 和 EEPROMBlockCountGet( ) 在 运行 时 确定 这 些 信息 。 

可 在 设备 和 块 级 别 配 置 密码 保护 用 于 读 取 和 写 入 访问 控制 来 支持 数据 保护 。 此 外 ， 块 可 
被 配置 为 仅 当 CPU 运行 在 管理 员 模 式 时 才 允 许 访问 。 第 二 个 保护 机 制 ， 允 许 一 个 或 多 个 
EEPROM 块 在 下 一 次 系统 复位 前 ， 完 全 不 能 使 用 软件 访问 。 

此 驱动 程序 包含 在 driverlib/ eeprom.c 中， 另外 driverlib/eeprom. h 包含 应 用 程序 使 用 的 
API 定义 。 

(2) EEPROM 固件 库 函 数 

EEPROM 的 AP 被 分 成 4 个 函数 组 : 

① 读 EEPROM。 

② 编程 EEPROM。 

③ 保护 EEPROM。 

④ 中 断 处 理 。 

常用 的 一 些 API 函数 列举 如 下 ， 较 详细 功能 介绍 请 见 附 录 H 的 EEPROM 部 分 

(1) 读 EEPROM 

e EEPROMRead( ) 。 

(2) 编程 EEPROM 

e EEPROMMassErase( ) 。 

e EEPROMProgram( ) 。 

e EEPROMProgramNonBlocking( ) 。 

(3) 保护 EEPROM 

e EEPROMBlockProtectGet( ) 。 

e EEPROMBlockProtectSet( ) 。 

e EEPROMBlockPasswordSet( ) 。 

e EEPROMBlockLock( ) 。 

e VEEPROMBlockUnlock( ) 。 

e EEPROMBlockHide( ) 。 
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(4) 中 断 处 理 

s EEPROMIntEnable( ) 。 
s EEPROMIntDisable( ) 。 
e EEPROMIntStatus( ) 。 
e EEPROMIntClear( ) 。 


10.S 例 程 


写 内 存 例 程 


本 小 节 将 以 TI 的 例 程 为 例 来 介绍 Flash 闪存 的 固件 库 使 用 方法 。 
1) 闪存 程序 。 


ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
//! 文 件 名 :write_flash. c 

//! 来 源 : 根据 TI 例 程 改编 

/A1 功 能 描述 : 癌 闪 存 写 入 数据 并 将 写 入 的 数据 读 出 ,显示 在 PuTTY“ 串口 助手 上 ” 


ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ボボ 








#include < stdint. h > 
#include < stdbool. h > 
#include "inc/hw_types. h" 








#include "inc/hw_memmap. h" 
#include " driverlib/sysctl hy" 
#include " driverhib/pin_map. h" 
#include " driverlib/debug. h" 
#include " driverlib/ gpio. h" 
#include " driverlib/flash. h" 
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/A1 初 始 化 控制 台 函数 


// ネネ ボネ ネネ ポポ ボネ ポポ ボネ ポポ ボネ ボボ ポポ ポポ ボボ ネネ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ 





void 
InitConsole( void ) 
| 
// 
// 使 能 GPIOA 的 UARTO 引 脚 
// 
SysCtlPeripheralEnable(SYSCTL_PERIPH_CPIOA ) ; 





// 

// 配 置 复 用 引 脚 A0 和 Al 为 UARTO 功能 
Xf 

GPIOPinConfigure( GPIO_PAO_UORX) ; 
CPIOPinConfigure(CPIO_PA1_UOTX) ; 
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// 

// 使 能 UARTO 以 便 可 以 配置 时 钟 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 








// 
// 使 用 内 部 16 MHz 振荡 器 作为 UART 时 钟 源 
// 


UARTClockSourceSet( UARTO_BASE, UART_CLOCK_PIOSC) ; 


// 

// 选 择 作为 UART 功能 的 引 脚 

// 

GPIOPinTypeUART(GPIO_PORTA_BASE,CPIO_PIN_0 | GPIO_PIN_1) ; 





// 
// 初 始 化 UART 的 控制 台 1/O 
// 


UARTStdioConfig(0,115200 ,16000000 ) ; 


int main( void ) 

| 
// 定 义 写 入 和 读 回 数据 的 类 型 
uint32_tpui32Data[ 2 ] ; 
uint132_tpu32Read| 2 ] : 


// 初 始 化 待 写 人 的 数据 
pui32Data[ 0 | = 0x123456ab: 
pui32Data[ 1 | =0x7891011c: 





// 配 置 系统 时 钟 频 率 为 40 MHz 
SysCtlClockSet(SYSCTL_SYSDIV_51SYSCTL_USE_PLLI 
SYSCTL_XTAL_16MHZISYSCTL_OSC_MAIN) ; 





炒米 炒米 炒米 洲 洲 炒米 米 玉米 洲 沙洲 洲 洲 炒米 炒米 沙洲 米 米 米 炒米 米 洲 洲 米 沙洲 炒米 沙洲 洲 洲 洲 米 炒米 炒米 洒 米 米 玉米 炒米 洲 洲 米 米 米 炒米 洲 沙洲 洲 米 炒米 炒米 沙沙 
//! 向 闪存 中 写 入 数据 
炒米 炒米 炒米 洲 洲 炒米 米 玉米 沙洲 洲 洲 洲 玉米 炒米 沙洲 炒米 炒米 炒米 洲 洲 米 米 米 玉米 沙洲 洲 洲 洲 米 炒米 米 沙洲 米 米 炒米 炒米 洲 洲 米 米 米 炒米 沙洲 洲 洲 洲 米 炒米 米 沙沙 
控除 内 存 中 的 1 个 块 
FlashErase(0x10000) ; 





// 在 PuTTY 中 显示 待 写 人 内 存 中 的 数据 

InitConsole( ) ; 

UARTprintf(" 例 程 中 待 写 人 和 从 闪存 中 读 回 的 数据 ;\n\n" ) ; 
UARTprintf(" 显 示 写 入 的 数据 :" ); 

UARTprintf(" %02x" , pui32Data[ 0 ] ) ; 

UARTprintf(" %02x" , pui32Data[ 1 ] ) ; 

UARTprintf(" \n" ) ; 
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// 在 新 擦 除 的 块 中 写 入 数据 
FlashProgram( pui32Data ,0x10000 , sizeof( pui32Data ) ) ; 


// 读 回 已 写 人 到 闪存 中 的 数据 
pui32Read[ 0] = ( * ( (volatile unsigned long * )0x00010000 ) ) ; 
pui32Read[ 1] = ( * ( (volatile unsigned long * )0x00010004 ) ) ; 





// 显 示 读 回 已 写 人 闪存 的 数据 
UARTprintf(" 显示 读 出 的 数据 :" ) ; 
UARTprintf(" %02x" , pui32Read[ 0 ] ) ; 
UARTprintf(" %02x" ,pui32Read[ 1] ) : 
UARTprintf(" \n" ) ; 


// 循 环 等 待 
while(1) 

| 

| 





| 


2) 创建 write_flash 工程 。 

3) 编译 write_flash 工程 生成 可 执行 的 . out 格式 文件 。 

4) 在 LaunchPad (EK - TM4C123GXL) 板 上 对 程序 进行 调试 。 

① 将 编译 生成 的 . Out 文件 导入 LaunchPad 板 中 。 

② 在 22 行 处 设置 一 个 断 点 ， 然 后 单 步 执 行程 序 ， 当 程序 指针 位 于 25 行 時 的 返 行 2 
如 图 10-3 所 示 。 




















(WW) TI Resource Explorer | *main.C 23 
し エエ 5 


ー 。 12 int main(void) 
| 






3 main() at CWUsersMiuyuwworkspace_v5_5write_flsah B 



















当 GPIO_DATA 的 值 不 为 0 时 ， 单 步 执 
行 完 该 条 语句 后 ， 此 值 将 变 为 0。 





uint32 t pu132Dat| , 










pui32Data [9] =9x12| PIO_DATA 
pu132Data[1] = 6x| PIO_DIR 


2 ee hr nds (YS PERIPH_GPIOF); 


OO 














图 10-3 清 零 GPIO_DATA 寄存 器 


从 图 10-3 中 可 以 看 到 ， 如 果 CPIO_DATA 寄存 器 的 值 不 为 0， 当 程序 执行 完 GPIOPin- 
Write( ) 后 ， 该 寄存 器 将 被 清 零 。 因 此 ， 观 察 到 的 多 二 果 部 符合 程序 所 表达 的 含义 。 

@ 在 29 行 FlashErase (0x10000 ) 处 设置 一 个 断 点 ， 当 单 步 执行 完 该 语句 后 的 结果 如 
图 10-4 所 示 。 
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I ~ テラ ンー ンマ ンー・・ ーー 


@x9999FF74 FFFFFFFFFFFFFFFFFFF 









// BFF90 FFF 
ノ we block of the 和信 深 除 地 址 革 Fac FFF 
っ 9 6FFC8 FFF 







F1ashErase(9x19999) : ば Qooo で 
// Program some data into Gy2999 4 
F1ashProgram( Du132Data, 而 











Ft 
@x99919999MIFFFFFFFFFFFFFFFF 


S Turn on red LED to indi#@ 0x の BOT991C FFFFFFFFFFFFFFFFFFF 
1 em(GPTO_PORTF_B 人 | 9x99919938 FFFFFFFF FFFFFFFF FFF 
程序 指针 駅 29999999): py 9x99919954 FFFFFFFF FFFFFFFF FFF 


@x99919979 FFFFFFFFFFFFFFFFFFF 




















器 











10-4 ” 擦 除 地 址 0x10000 处 的 数据 


从 图 10-4 可 以 看 到 ， 当 执行 完 该 条 语句 后 的 确 擦 除了 地 址 为 0x10000 处 的 数据 。 
然后 继续 单 步 执行 ， 当 执行 完 FlashProgram( ) 语 句 后 的 结果 如 图 10-5 所 示 。 


OKXowwwrroo rrrrrrrrrrrrrrrr rrr 


シン 断 点 ] _ ~ | 9x99eeFF74 
- Ee a block of the flash. ayQ999FF99 


F1ashErase(9x19999 ) ; 
// Program some data into the nel 


证 EEN pui32Data, 9x19999 , 5 っ ao 


// Turn on red LED to indicate co oe 


23456AB 7891611C HFF 
3 GPIOPinWrite(GPIO PORTF_BASE,GPIO Tr. PT 


5 者 
CEUDJmyO200605009)5 § ~ oxo0010038 FFFFFFFFFFFFFFFFFFF 

| @x99619954 FFFFFFFF FFFFFFFF FFF 

FE @x69919976 FFFFFFFF FFFFFFFF FFF 


图 10-5 向 地 址 0x10000 写 入 的 数据 


















nl 
i 




















从 图 10-5 可 以 看 到 ， 写 入 的 数据 和 从 闪存 中 读 re | 
出 的 数据 完全 相同 ， 验 证 了 程序 功能 正确 。 钢 程 中 待 写 入 和 从 闪存 中 读 回 的 数据 : 

$) 在 LaunchPad (EK -TM4C123GXL) 板 上 对 
程序 进行 测试 。 将 编译 生成 的 .out 文件 下 载 到 
LaunchPad 板 中 ， 让 程序 全 速 在 LaunchPad 板 中 运行 。 
从 地 址 0x10000 和 0x10004 读 出 的 闪存 数据 和 程序 中 
待 写 入 的 数据 相同 ( 见 图 10-5)。 这 时 打开 PuTTY 
“串口 助手 ”， 其 测试 结果 如 图 10-6 所 示 。 

从 图 10-6 中 可 以 看 到 写 入 到 闪存 中 的 数据 和 读 出 的 数据 完全 相同 ， 验 证 了 write_ 
flash. c 程序 的 正确 性 。 








图 10-6 待 写 人 和 从 闪存 中 读 回 
数据 的 测试 结果 








读 写 EEPROM 例 程 


本 小 节 将 以 TI 的 例 程 为 例 介 绍 EEPROM 固件 库 的 使 用 方法 。 
1) 读 写 EEPROM 程序 。 


ポポ ポポ ポポ ポポ ホ ポポ ホホ ポポ ポポ ホ ポポ ホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホ ポポ ポポ ホ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
//! 文 件 名 :Write_eeprom. c 

//! 来 源 ， 根据 TI 例 程 改编 

//! 功 能 描述 : 读 写 EEPROM 中 的 数据 并 在 PuTTY 中 显示 出 来 


ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネギ 





#include < stdint. h > 
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#include < stdbool. h > 
#include "inec/hw_types. h" 
#include "inc/hw_memmap. h" 
#include " driverlib/ sysctl. h" 
#include " driverlib/ pin_map. h" 
#include " driverlib/ debug. h" 
#include " driverlib/ gpio. h" 
#include " driverlib/flash. h" 
#include " driverlib/eeprom. h" 
#include " driverlib/uart. hy" 
#include " utils/uartstdio. h" 


// 米 米 米 六 六 米 六 六 米 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 
sa 着 
/AI 初始 化 控制 台 函 数 


// ネネ ボネ ネネ ポポ ボネ ポポ ボネ ボボ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ 





void 
InitConsole( void ) 
| 
// 
// 使 能 GPIOA 的 UARTO 引 脚 
// 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 
// 
// 配 置 复 用 引 脚 A0 和 Al 为 UARTO 功能 
// 
GPIOPinConfigure( CPIO_PA0_UORX) ; 
GPIOPinConfigure( CPIO_PA1_UOTX ) ; 
ZN 
// 使 能 UARTO 以 便 可 以 配置 时 钟 
// 
SysCLPeripheralEnable( SYSCTL_PERIPH_UARTO ) ; 
// 
// 使 用 内 部 16 MHz 振荡 器 作为 UART 时 钟 源 
// 
UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 
// 
// 选 择 这 些 引 脚 的 复 用 (UART) 功能 
// 
GPIOPinTypeUART( GPIO_PORTA_BASE ,GPIO_PIN_O | CPIO_PIN_1 ) ; 
// 
// 初 始 化 UART 的 控制 台 IO 
// 
UARTSidioConfig(0 ,115200 ,16000000) : 

















int main( void ) 


uint32_t pui32Data[ 2 ] ; 
uint32_t pui32Read[ 2 ] ; 
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pui32Data[ 0 | = 0x12345678 ; 

pui32Data| 1 | = 0x98abcde; 

// 配 置 系统 时 钟 频率 为 40MHz 

SysCtlClockSet( SYSCTL_SYSDIV_5ISYSCTL_USE_PLL | 
SYSCTL_XTAL 16MHZISYSCTL_OSC_MAIN) ; 








// 使 能 EEPROM 外 设 

SysCtlPeripheralEnable( SYSCTL_PERIPH_EEPROMO ) ; 
// 初 始 化 EEPROM 

EEPROMInit( ) ; 


// 块 擦 除 EEPROM 
// 注 意 :EEPROM 与 flash 不 同 , 在 写 和 人 前 可 以 不 擦 除 其 中 的 内 容 , 即 这 步 视 情况 可 省 略 
EEPROMMassErase( ) ; 














// 读 出 块 擦 除 后 的 EEPROM 中 的 数据 
EEPROMRead(pui32Read ,0x0 ,sizeof( pui32Read ) ) ; 





// 在 PuTTY 中 显示 待 写 入 闪存 中 的 数据 

InitConsole( ) ; 

UARTprintf(" ** 例 程 中 待 写 信 和 从 EEPROM 中 读 回 的 数据 ** \n\n" ) ; 
UARTprintf(" 显示 写 和 的 数据 :" ) ; 

UARTprintf(" %02x" , pui32Data[ 0 ] ) ; 

UARTprintf(" %02x" , pui32Data[ 1 ] ) ; 

UARTprintf(" \n" ) ; 

















// 向 擦 除 后 的 EEPROM 中 写 人 数据 
EEPROMProgram( pui32Data ,0x0 ,sizeof( pui32Data) ) ; 


// 读 出 向 EEPROM 中 写 人 的 数据 
EEPROMRead(pui32Read ,0x0 ,sizeof( pui32Read ) ) ; 


// 显 示 读 回 已 写 人 到 EEPROM 中 的 数据 
UARTprintf(" 显示 读 出 的 数据 :" ) ; 
UARTprintf(" %02x" ,pui32Read[0] ) ; 
UARTprintf(" %02x" , pui32Read[ 1 ] ) : 
UARTprintf(" \n" ) ; 





// 循 环 等 待 
while(1) 
| 


1 
i 





1 
i 


2) 创建 write_eeprom 工程 。 
3) 编译 工程 生成 . out 格式 可 执行 文件 。 
4) 导入 .out 文件 到 LaunchPad 板 中 ， 并 在 表达 式 (Expressions) 窗口 中 添加 pui32Data 
和 pui32Read 两 个 变量 ， 并 把 数据 设置 成 hex 格式 ， 如 图 10-7 所 示 。 
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@9- Variables 人鱼 Expressions 8 WN Registers 加 | 
蕊 法 加 | 年 其 了 村 | 
Expression Type Value Address 
: 访 /Pui32Data unsigned int[2] Ox20000100 (Binary) 0x20000100 
人 pui32Read ノ unsiqned int[2] Ox20000108 (Hex) 0x20000108 







































到 


10-7 添加 待 写 和 人 的 数据 和 读 回 数据 变量 











5) 在 LaunchPad (EK -TM4C123GXL) 板 上 对 程序 进行 调试 。 
CR 以 观察 块 擦 除 语句 是 否 能 擦 除 EEPROM 中 的 
数据 ， 其 单 步 执 行 结果 如 图 10-8 所 示 。 


UNCIZ LU ロロ エフ と い ビ ロロ ニョ 


pu132Data「9] = 9x 





























访 pui32Data unsigned int[2] Ox200000E0 (Binary) | 
:= [0] unsigned int 0x12345678 (Hex) 


的 = unsigned int Ox098ABCDE (Hex) 
se wored na 0x200000E8 (Hex 
9: TO unsigned int OxFFFFFFFF (Hex) 


0: [1] unsigned int 





SysC て CrockSet(SYSI“ 
// 司 能 EEPROM 外 设 。 
SysCtlPeripheralE 
// 初 始 化 EEPROM。 
EEPROMInit() : 

// 据 擦 除 EEPROM。 
EEPROMMassErase( ) jj 
// 读 出 块 探 除 后 的 EEPRORT 下巴 



















多 
at ES か 9x9, sizeof(pui32Read)) : 
// 在 PuTTY 中 显示 待 写 入 闪存 中 的 数据 。 

NSX 5 

hpTaxintf("** 例 程 中 待 写 入 和 从 EEPROM 中 读 
ntf(" 显 示 写 入 的 数据 :"); 

ntf(" %92x" , pui32Data[81); 


图 10-8 单 步 执行 块 擦 除 语句 后 的 结果 


② 在 HI ) 处 设置 一 个 断 点 ， 以 观察 从 EEPROM 中 读 回 的 数据 是 否 等 于 写 入 
的 数据 ， 其 单 步 执行 结果 如 图 10-9 所 示 。 


















EEPROM 被 探 除 








ロロ 








的 数 失 











作 















// 读 和 
Fer 待 写 入 的 数据 = 读 出 的 数据 有 


a Expression Types 必 Value Address 


UARTI unsigne$ 0x12345678 (Hex) 

UART| = unsigned i ER 0x200000E4 
UARTI 4 只 ui32Read» unsigned int Ox200000E8 (Hex) | 0x200000E8 
UART b unsignedint | 0x12345678 (Hex) | 0x200000E8 
// 向 8 unsigned int 0x200000EC 
/7/ 读 出 向 EEPROM 中 写 六 的 数据 。 
EEPROMRead (pui32Read, 9x9, s1zeof(pu132Read) ) : 


// 显 示 读 回 已 写 入 到 EEPROM 中 的 数据 。 
UARTprintf(" 显 示 读 出 的 数据 :"); 


人 ABTnrintf(" %92x"。 pu132Read[9] ) : 
ntf(" %92x" 。 pui32Read[ 1] ) : 
mh EN nN 


图 10-9 单 步 执行 从 EEPROM 中 读 回 的 数据 























































在 图 10-9 可 以 看 到 从 EEPROM 中 读 出 的 数据 等 于 写 入 的 数据 ， 这 就 验证 了 该 段 程 序 的 
正确 性 。 
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6) 在 LaunchPad (EK - TM4C123GXL) 板 上 对 程序 进行 测试 。 打 开 PuTTY “串口 助 
手 ” 全 速 运行 程序 ， 其 测试 结果 如 图 10-10 所 示 。 




















中 COM7 - PuTTY 
*#* 例 程 中 待 写 入 和 从 EEPROM 中 读 回 的 数据 ** 








图 10-10 write_eeprom.c 程序 的 运行 结果 
从 PuTTY 显示 的 结果 来 看 ，write_eeprom. c 程序 实现 了 写 人 和 读 出 写 和 人 数据 的 功能 。 这 
时 还 可 以 在 表达 式 (Expressions ) 窗口 查看 pui32Data 和 pui32Read 的 显示 结果 (如 
图 10-11 所 示 ) 。 












































Variables peo Registers 
= 沌 円 | 中 滨 
Expression Type Value 
4 絡 pui32Data unsigned int[2] Ox200000E0 (Binary) 


or- [0] unsigned int 0x12345678 (Hex) 0x200000E0 
= [1] unsigned int 0x098ABCDE (Hex ーー 


4 pui32Read 。 unsigned int[2] Ox200000E8 (Hex) | 读 出 的 数据 


oa: [0] unsigned int IOx12345678 (HeX) 0 の OF8 
o= [1] unsigned int IDx098ABCDE (Hex) 


党 Add new exp 










Ox200000EC 





«| HI ト 





图 10-11 在 表达 式 窗 口 的 写 人 数据 和 读 出 数据 


从 图 10-11 可 看 到 ， 写 入 EEPROM 的 数据 和 从 EEPROM 读 回 的 数据 完全 相同 ， 这 就 在 
硬件 平台 上 验证 了 程序 功能 的 正确 性 。 
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wo 第 [ls 


通用 定时 兹 (GPTM ) 


通用 定时 器 (General - Purpose Timer, GPT) 用 于 对 驱动 定时 需 输 入 引 脚 的 外 部 事件 进 
行 计数 /定时 。TM4C123GH6PM 通用 定时 器 模块 (CPTM ) 具有 6 个 16/32 位 的 GPTM 模块 
与 6 个 32/64 位 宽 的 GPTM 。 每 个 16/32 位 GPTM 可 提供 2 个 16 位 的 定时 器 /计数 器 ( 即 
Timer A 和 Timer B) ， 用 户 可 将 其 配置 成 独立 运行 的 定时 需 或 事件 计数 器 ， 或 使 之 连接 成 一 
个 32 位 定时 需 或 一 个 32 位 实时 时 钟 (RTC) 。 每 个 32/64 位 宽 的 GPTM 不 但 可 以 为 Timer A 
和 Timer B 提供 32 位 定时 器 ， 而 且 用 户 还 可 将 它们 连接 成 一 个 64 位 定时 器 。 

另外 ， 定 时 器 也 可 以 用 来 触发 ADC 转换 与 DMA 传输 。 所 有 通用 定时 器 的 ADC 触发 
言 号 在 到 达 ADC 模块 之 前 可 对 其 进行 或 运算 ， 因 此 仅 需 一 个 定时 器 就 可 触发 ADC 事件 。 

通用 定时 器 模块 是 Tiva C 系列 微 控 制 右 一 个 可 用 的 定时 资源 。 与 之 相对 应 的 其 他 定时 
器 资源 是 指 系统 定时 器 (SysTick) 和 了 PWM 模块 的 PWM 定时 器 。 

定时 器 API 为 定时 器 模块 提供 了 一 组 用 于 定时 器 的 配置 与 控制 、 修 改定 时 器 /计数 器 的 
值 与 管理 定时 器 的 中 断 处 理 的 函数 。 

该 驱动 程序 包含 在 Driverlib/ timer c 中 , Driverib/ timer h 包含 了 定时 器 API 函数 的 定义 。 


本 章 的 主要 内 容 : 


ヶ 通用 定时 器 单元 
> GPTM 固件 库 函数 ( 见 附录 了 T) 
> 例 程 

















主要 特 点 


通用 定时 器 模块 提供 的 功能 选择 如 下 : 

1) 16/32 位 操作 模式 : 

① 16/32 位 可 编程 的 单 次 定时 器 。 

② 16/32 位 可 编程 的 周期 定时 器 。 

@ 包含 8 位 预 分 频 的 16 位 通用 定时 器 。 

④ 当 使用 32. 768 kHz 的 外 部 时 钟 输入 时 ， 可 作为 32 位 的 实时 时 钟 。 
⑤ 包含 8 位 预 分 频 的 16 位 输入 沿 计数 或 定时 捕获 模式 。 
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⑥ 包含 8 位 预 分 频 的 16 位 PWM 模式 和 可 软件 编程 的 PWM 信号 反 相 输出 。 
2) 32/64 位 操作 模式 : 


① 32/64 位 可 编程 的 单 次 定时 器 。 
② 32/64 位 可 编程 的 周期 定时 器 。 


③ 包含 16 位 预 分 频 的 32 位 通用 定时 器 。 
④ 当 使 用 32. 768 kHz 的 外 部 时 钟 源 时 ， 可 作为 64 位 的 实时 时 钟 。 


⑤ 包含 16 位 预 分 频 的 32 位 输入 沿 计数 或 定时 捕获 模式 。 
⑥ 包含 16 位 预 分 频 的 32 位 PWM 模式 和 可 软件 编程 的 PWM 信和 号 反 相 输出 。 


3) 增 、 减 计数 。 


4) 12 个 16/32 位 捕获 比较 PWM 引 脚 (CCP) 。 

$) 12 个 32/64 位 捕获 比较 PWM 引 脚 (CCP) 。 

6) 菊花 链 式 的 定时 器 模块 允许 一 个 定时 器 启动 多 个 定时 事件 。 
7) 定时 器 同步 允许 选择 的 定时 需 在 同一 时 钟 周期 开始 计数 。 


8) ADC 事件 触发 。 





9) 在 调试 过 程 中 ， 当 CPU 出 现 暂停 标识 时 ， 用 户 可 以 中 止 定时 需 事 件 ( 不 含 RTC 模 式 ) 。 
10) 可 确定 从 发 出 中 断 请 求 到 进入 中 断 服务 程序 所 花 的 时 间 。 
11) 使用 wDMA 来 高 效 传输 数据 : 
① 每 个 定时 器 的 专用 通道 。 

② 定时 器 中 断 响应 突 发 请 求 。 


GPTM 模块 框图 


通用 定时 需 的 模块 框 如 岁 11-1 所 示 。 
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0x0000 递减 计数 器 模式 16-/32 位 》 
OxFFFF (递增 计数 器 模式 16-/32 位 ) 
0x0000.0000《〈 递 减 计 数 器 模式 32-/64 位 ) 
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图 11-1 


通用 定时 右 的 模块 框图 


OxFFFF.FFFF 〈 递 增 计 数 器 模式 32-/64 位 ) 


出 











时 钟 /边沿 
检测 








RTC 分 频 器 


RTC 预 分 频 器 


GPTMRTCPD 


时 钟 /边沿 





检测 


32KHz 或 偶 
数 CCP 管 肢 






奇数 CCP 管 肢 


信号 描述 





表 11-1 列 出 了 SSI 模块 的 外 部 信号 ， 并 描述 了 每 个 信号 的 功能 。 
表 11-1 通用 定时 器 信号 描述 (64LQFP) 



































































































































































































































引 脚 名 称 | 引 肢 编号 引 脚 复 用 /赋值 引 脚 类 型 | 缓冲 区 类 描述 

1 PB6(7 5 区 
TOCCPO 2 人 1/0 TTL 16/32 位 定时 器 0 捕捉 /比较 /PWM 0 

PB7(7 ee 

TOCCP1 2 pF . 4 1/0 TTL 16/32 位 定时 器 0 捕捉 /比较 /PWMI1 

30 PF2(7 SS 0 
TICCPO PR 0 | 1/0 TTL 16/32 位 定时 器 1 捕捉 /比较 /PWMO 

31 PF3(7 a 二 
TICCP1 a | 1/0 TTL 16/32 位 定时 器 1 捕捉 /比较 /PWMI1 

PF4(7 gp 

T2CCPO 上 | 1/0 TTL 16/32 位 定时 器 2 捕捉 /比较 /PWM0 
T2CCP1 46 PB1(7) 1/0 TTL 16/32 位 定时 器 2 捕捉 /比较 /PWMI1 
T3CCPO 47 PB2(7) 1/0 TTL 16/32 位 定时 器 3 捕捉 /比较 /PWM0 
T3CCP1 48 PB3(7) 1/0 TTL 16/32 位 定时 器 3 捕捉 /比较 /PWMI1 
T4CCPO 52 PCO(7) 1/0 TTL 16/32 位 定时 器 4 捕捉 /比较 /PWM0 
T4CCP1 51 PC1(7) 1/0 TTL 16/32 位 定时 器 4 捕捉 / 比 絞 /PWMI1 
TSCCPO 50 PC2(7) 1/0 TTL 16/32 位 定时 器 5 捕捉 /比较 /PWM0 
TSCCP1 49 PC3(7) 1/0 TTL 16/32 位 定时 器 5 捕捉 /比较 /PWMI1 
WTOCCPO 16 PC4(7) 1/0 TTL 32/64 位 宽 位 定时 器 0 捕 提 /比较 /PWMO 
WTOCCP!1 15 PC5(7) 1/0 TTL 32/64 位 宽 位 定时 器 0 捕捉 /比较 /PWMI1 
WT1CCPO 14 PC6(7) 1/0 TTL 32/64 位 宽 位 定时 器 1 捕捉 /比较 /PWM0 
WTICCPI 13 PC7(7) 1/0 TTL 32/64 位 宽 位 定时 器 1 捕捉 /比较 /PWMI1 
WT2CCPO 61 PD0(7) 1/0 TTL 32/64 位 宽 位 定时 器 2 捕捉 / 比 絞 /PWM0O 
WT2CCP1 62 PD1(7) 1/0 TTL 32/64 位 宽 位 定时 器 2 捕捉 /比较 /PWMI1 
WT3CCPO 63 PD2(7 ) 1/0 TTL 32/64 位 宽 位 定时 器 3 捕捉 /比较 /PWM0 
WT3CCP1 64 PD3 (7 ) 1/0 TTL 32/64 位 宽 位 定时 器 3 捕捉 / 比 絞 /PWM1 
WT4CCPO 43 PD4(7 ) 1/0 TTL 32/64 位 宽 位 定时 器 4 捕捉 /比较 /PWM0 
WT4CCP1 44 PDS (7 ) 1/0 TTL 32/64 位 宽 位 定时 器 4 捕捉 /比较 /PWMI1 
WTSCCPO 53 PD6(7 ) 1/0 TTL 32/64 位 宽 位 定时 器 5 捕捉 / 比 絞 /PWM0O 
WT5CCP1 10 PD7(7) 1/0 TTL 32/64 位 宽 位 定时 器 5 捕捉 / 比 絞 /PWM1 

ob A 

功能 简介 


每 个 GPTM 的 主要 元 件 为 2 个 自由 运行 
2 个 匹配 寄存 器 、2 个 预 分 频 器 匹配 寄存 器 


相关 的 控制 功能 。 





定时 器 模块 提供 两 


者 配置 成 全 宽 定时 天 或 实时 时 钟 (RTC)。 


递增 /递减 计数 器 〈 称 作 TimerA 和 TimerB ) 、 


个 影子 寄存 器 


、2 个 加 载 / 初 始 化 寄存 器 及 其 


个 半 宽 的 定时 器 /计数 器 ， 可 配置 成 独立 运行 的 定时 器 或 事件 计数 器 ， 或 
Et 了 16 位 的 半 宽 


一 些 定时 带 提 供 





定时 器 和 一 个 32 位 的 全 
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宽 定 时 器 ， 而 其 他 定时 器 提供 了 32 位 半 宽 定时 器 和 一 个 64 位 的 全 宽 定时 器 。API 在 一 个 定时 器 
模块 里 提供 两 个 半 宽 的 定时 器 分 别称 为 TimerA 和 TimerB ， 而 全 宽 定 时 器 称 为 J 

当 配置 为 全 宽 或 半 宽 定时 器 时 ， 定 时 器 可 以 设置 为 单 次 触发 定时 器 或 一 个 连续 的 计时 
器 。 如 果 配 置 为 单 次 模式 ， 当 定时 器 向 下 计数 到 0 或 者 计数 到 装载 值 时 ， Rs 
数 。 如 果 配 置 为 连续 模式 ， 定 时 器 计数 到 0 (向 下 计数 ) 或 装载 值 (向 上 计数 ) 时 ， 定 时 
器 将 重新 装载 初 值 并 继续 计数 。 当 配置 为 一 个 全 宽 的 定时 器 时 ， 该 定时 器 也 可 以 被 配置 成 
RTC。 在 这 种 模式 下 ， 定 时 器 希望 由 一 个 32. 768 kHz 的 外 部 时 钟 来 驱动 ， 该 时 钟 被 分 频 用 于 
产生 1s 的 时 钟 节拍 。 

当 在 半 宽 模式 下 ， 和 定时 器 也 可 以 配置 为 事件 捕获 或 者 作为 脉冲 宽度 调制 (PWM) 发 生 
器 。 当 配置 为 事件 捕获 时 ， 定 时 器 作为 计数 器 。 它 可 配置 成 计数 两 个 事件 之 间 的 时 间或 计数 
事件 本 身 。 被 计数 的 事件 可 被 配置 成 上 升 沿 、 下 降 沿 或 者 双边 沿 。 当 定时 器 被 配置 为 PWM 
发 生 恬 时 ， 用 于 捕获 事件 的 输入 信号 变 为 输出 信和 号， 定时 器 可 用 于 驱动 一 个 边沿 对 齐 的 脉冲 
到 该 信号 上 。 

定时 器 模块 还 提供 了 能 够 控制 其 他 功能 的 参数 ， 如 输出 反 转 、 输 出 触发 、 中 止 期 间 定时 
器 的 行为 。 

此 外 ， 定 时 器 模块 还 提供 了 中 断 源 和 事件 的 控制 。 用 生成 的 中 断 指 示 一 个 事件 已 捕获 或 者 一 
定数 量 的 事件 已 捕获 。 当 定时 器 已 向 下 计数 到 0 或 定时 器 匹配 一 个 特定 的 值 时 也 可 产生 中 断 。 

TM4C1233H6PM 还 可 以 从 多 个 定时 器 模块 进行 计数 器 同步 。 同 步 计数 器 对 于 PWM 和 边 
沿 定时 捕获 模式 较 有 帮助 。 在 PWM 模式 下 ，PWM 从 多 个 定时 器 输出 ， 可 被 具有 相同 的 加 
载 值 锁 步 使 其 可 同步 计数 。 类 似 地 ， 在 边沿 定时 捕获 模式 下 ， 使 用 相同 的 加 载 值 和 同步 计数 
器 ， 使 两 个 输入 边沿 之 间 的 绝对 时 间 可 很 容易 地 测量 。 

表 11-2 列 出 各 GPTM 可 用 的 模式 。 

表 11-2 通用 定时 器 功能 












































































































































模式 | 下 | 秆 数 谊 疝 ae UP 
使用 16/32 位 | 32/64 位 | 16/32 位 32/64 位 宽 (计数 器 方向 ) 
GPTM | 宽 CPTM | GPTM GPTM 
給水 特 代 独立 “| 递增 或 递减 | 16 位 32 位 8 位 16 位 tt Nt a 
级 联 | 递增 或 递减 | 32 位 64 位 一 一 N/A 
局面 独立 “| 递增 或 递减 | 16 位 32 位 8 位 16 位 
级 联 | 递增 或 递减 | 32 位 64 位 一 一 N/A 
RTC 级 联 递增 32 位 64 位 二 一 N/A 
边沿 计数 独立 | 递增 或 递减 | 16 位 32 位 8 位 16 位 定时 器 扩展 〈 双 向 ) 
边沿 定时 独立 “| 递增 或 递减 | 16 位 32 位 8 位 16 位 定时 需 扩 展 〈 双 向 ) 
PWM 独立 递减 16 位 32 位 8 位 16 位 定时 器 扩展 
① 仅 在 独立 使 用 定时 器 时 可 使 用 预 分 频 器 。 
注 : 
1. 在 单 次 或 周期 模式 下 的 递减 计数 时 ， 预 分 频 器 用 作 真 预 分 频 器 且 包 含 计数 的 最 低位 。 
2. 在 单 次 或 周期 模式 下 的 递增 计数 时 ， 预 分 频 器 用 作 定 时 器 扩展 且 包 含 计数 的 最 高 位 。 





















































3. 在 输入 沿 计数 、 输 入 沿 定时 与 PWM 模式 时 ， 预 分 频 器 用 作 定 时 器 扩展 ， 而 无 需 关 心计 数 方向 。 
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1. 定时 器 模式 

本 小 节 将 简介 几 种 常用 定时 器 模式 的 运行 机 制 。 

(1) 单 次 触发 /周期 定时 器 模式 

单 次 触发 /周期 定时 器 包括 以 下 模式 . 

① 增 / 减 计数 模式 。 

② 等 待 触发 模式 。 

@) 单 次 触发 模式 。 当 定时 器 满足 条 件 后 将 停止 计数 并 清除 标志 位 。 

④ 周期 模式 。 计 数 器 从 0 开始 递增 计数 到 装载 值 ， 重 新 自动 装载 初 值 ， 并 从 0 开始 重 
新 计数 ， 计 数 器 从 预 装 载 值 开始 递减 计数 并 重新 装载 预 装 载 值 。 

⑤ nDMA 触发 模式 。 

选择 单 次 触发 /周期 模式 可 依据 写 入 到 模式 寄存 器 (GPTMTnMR) 中 TnMR 字段 的 
值 来 确定 ， 而 定时 器 是 递增 计数 还 是 递减 计数 由 GCPTMTnMR 寄存 器 中 的 TnCDIR 位 来 
确定 。 

在 软件 将 GPTM 控制 寄存 器 (GPTMCTL) 中 的 TnEN 位 置 位 时 ， 定 时 器 将 从 0x0 开始 递 
增 计数 或 从 预 装载 的 值 开 始 递减 计数 。 此 外 ， 若 GPTMTnMR 寄存 器 中 的 TnWOT 位 被 置 位 ， 
在 TnEN 位 置 位 时 ， 定 时 器 将 会 等 待 一 个 触发 来 启动 计数 。 在 使 能 定时 器 时 将 要 装载 到 定时 
器 寄存 器 的 值 见 表 11-3。 








表 11-3 使 能 定时 器 时 寄存 器 的 值 。 









































寄 存 器 递减 计数 模式 递增 计数 模式 
GPTMTnR GPTMTnILR 0x0 

GPTMTnV GPTMTnILR 0x0 

GPTMTnPS 独立 模式 : GPTMTnPR: 级 联 模式 不 可 独立 模式 为 0x0; 级 联 模式 不 可 用 
GPTMTnPV 独立 模式 : CPTMTnPR, 级 联 模式 不 可 独立 模式 为 0x0; 级 联 模式 不 可 用 





























当 定 时 需 做 递减 计数 并 到 达 超 时 事件 (0x0) 时 ， 定 时 需 将 在 下 一 个 时 钟 周期 从 
GPTMTnILR 与 GPTMTnPR 寄存 器 中 重新 装载 初 值 。 当 定时 需 做 递增 计数 并 达到 超时 事 
件 (GPTMTnILR 和 可 选 CPTMTnPR 寄 存 稚 中 的 数 値 ) 时 ， 定 时 器 将 会 重新 装载 0x0。 
若 将 定时 器 配置 为 单 次 触发 模式 ， 则 定时 器 将 停止 计数 ， 并 将 GPTMCTL 寄存 器 中 的 
TnEN 位 清 零 ; 如 果 将 定时 器 配置 为 周期 模式 ， 则 定时 器 将 在 下 一 个 时 钟 周 期 重新 开始 
计数 。 

在 周期 、 快 照 模式 ( 即 GPTMTnMR 寄存 器 中 的 TnMR 字段 为 0x*2，TnSNAPS 位 =1) 发 
生 超时 事件 时 ， 定 时 器 的 值 将 被 加 载 到 CPTMTnR 寄存 器 ， 而 预 分 频 器 的 值 会 被 加 载 到 GPT- 
MTnPS 寄存 器 中 。 自 由 运行 计数 器 的 值 将 显示 在 GPTMTnV 寄存 器 中 ， 自 由 运行 预 分 频 器 的 
值 会 显示 在 GPTMTnPV 寄存 器 中 。 通 过 此 方式 ， 软 件 可 校 验 快 照 值 和 自由 运行 定时 器 的 当 
前 值 ， 使 之 可 确定 从 中 断 发 生 到 进入 中 断 处 理 程序 之 间 所 花费 的 时 间 。 注 意 ， 当 定时 器 配置 
为 单 次 触发 模式 时 ， 快 照 模 式 不 可 用 。 

除 重 载 初 值 外 ， 在 定时 器 达到 超时 事件 时 将 会 被 触发 并 产生 超时 中 断 ; 当 GPTMT- 
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nMR 寄存 器 中 的 ToMIE 位 置 位 时 ,在 定时 器 的 值 与 加 载 到 匹配 寄存 器 (CPTMT- 
nMATCHR) 和 预 分 频 匹 配 值 寄 存 器 (GPTMTnPMR) 的 值 相等 时 ， 也 将 产生 中 断 条 件 。 
通过 将 CPTMCTL 中 的 TnOTE 位 置 位 可 启动 ADC 触发 ， 当 ADC 触发 器 使 能 时 ， 仅 单 次 
触发 或 周期 超时 事件 使 ADC 触发 器 有 效 。 可 通过 配置 并 使 能 相应 的 pDMA 通道 来 开启 
kDMA 触发 右 。 

若 软 件 在 计数 器 递减 计数 时 更 新 了 CPTMTnILR 或 CPTMTnPR 寄存 器 ， 计 数 器 将 在 下 一 
个 时 钟 周期 装载 新 值 ; 若 GPTMTnMR 寄存 器 中 的 TnILD 位 被 清 零 ， 则 计数 器 将 从 新 值 开始 
继续 计数 ; 如果 TnILD 位 被 置 位 ， 计 数 器 将 在 下 一 个 超时 事件 后 加 载 新 值 ， 如 果 软 件 在 计 
数 器 递增 计数 时 更 新 了 GPTMTnILR 或 GPTMTnPR 寄存 器 ， 超 时 事件 会 在 下 一 个 时 钟 周 期 变 
更 为 新 值 ， 如 果 软 件 在 计数 器 递增 或 递减 计数 时 更 新 了 GPTM Timer n 值 寄 存 器 (GPTMTnV) 
的 值 ， 计 数 需 将 会 在 下 个 时 钟 周 期 载 人 这 个 新 值 并 从 该 值 开始 递增 或 递减 计数 ; 若 软件 更 新 
了 GPTMTnMATCHR 或 CPTMTnPMR 寄存 器 ， 新 值 会 在 下 一 个 时 钟 周期 反映 出 来 ; 如果 
TnMRSU 位 被 置 位 ， 新 值 将 在 下 一 个 超时 事件 后 才 会 生效 。 

(2) 实时 时 钟 模式 

实时 时 钟 模式 仅 支 持 递 增 计数 模式 ， 复 位 后 计数 器 的 值 为 0x01， 见 表 11-4。 


表 11-4 在 RTC 模式 下 的 计数 器 值 




































































寄 存 器 递减 计数 模式 递增 计数 模式 
GPTMTnR 不可 用 Oxl 
GPTMTnV 不 可 用 Oxl 
GPTMTnPS 不 可 用 不 五 
GPTMTnPV 不 可 用 不 五 


在 RTC 模式 中 ， 要 求 CCPO 引 脚 的 输入 时 钟 为 32.768 kHz。 
然后 将 其 分 频 为 1 Hz。 在 软件 写 CPTMCTL 寄存 器 中 的 TAEN 位 
时 ,计数 器 将 从 预 装 载 值 0xl 开始 递增 计数 。 当 计数 器 值 与 GPT- 
MTAMATCHR 寄存 右 中 预 装载 值 匹配 时 ，GCPTM 将 使 GPTMRIS 寄 
存 器 中 的 RTCRIS 位 生效 ， 并 开始 继续 计数 ， 直 到 发 生硬 件 复位 
或 被 软件 禁止 (通过 清 零 TAEN 位 )。 当 定时 器 的 值 达到 最 终 计 
数值 时 ， 定 时 器 将 会 返回 到 0x0 继续 递增 计数 。 如 果 在 GPT- 
MIMR 寄存 器 中 使 能 RTC 中 断 ， 则 GPTM 还 将 置 位 GPTMMIS 寄 
存 器 中 的 RTCMIS 位 并 产生 控制 器 中 断 。 通 过 写 CPTMICR 寄存 器 
中 的 RTCCINT 位 可 将 状态 标志 清除 。 

为 了 确保 RTC 值 的 一 致 性 ， 其 软件 流程 如 图 11-2 所 示 。 

(3) 输入 边沿 计数 模式 

在 该 模式 中 ， 最 大 输入 频率 为 1/4 系统 频率 ， 定 时 器 配置 为 
24 位 或 48 位 增 / 减 计数 器 ， 包 括 带 有 存储 在 通用 定时 器 n 中 的 预 
分 频 寄存 器 (GPTMTnPR) 中 的 高 计数 值 和 GPTMTnR 寄存 器 中 
低位 的 可 选 预 分 频 器 。 在 该 模式 下 ， 定 时 器 可 捕捉 到 三 种 事件 类 





























图 11-2 读 RTC 值 的 
流程 图 
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型 : 上 升 沿 、 下 降 沿 或 双 沿 。 为 了 把 定时 器 设置 为 边沿 计数 模式 ，GPTMTnMR 寄存 器 中 的 
TnCMR 位 必须 清 零 。 定 时 需 计 数 时 所 采用 的 边沿 类 型 由 CPTMCTL 寄存 器 中 的 TnEVENT 字 
段 决 定 。 在 递减 计数 模式 的 初始 化 期 间 ， 需 配置 GPTMTnMATCHR 和 GPTMTnPMR 寄 存 器 , 
使 GPTMTnILR 和 CPTMTnPR 寄存 器 与 CPTMTnMATCHR 和 GPTMTnPMR 寄存 器 之 间 的 差 值 
等 于 待 计算 的 边沿 事件 的 个 数 。 在 递增 计数 模式 中 ， 定 时 器 从 0x0 开始 计数 直到 GPTMT- 
nMATCHR 和 GPTMTnPMR 寄存 器 中 的 值 见 表 11-5。 


表 11-5 当 定 时 器 使 能 时 输入 边沿 计数 模式 的 计数 器 值 














寄 存 器 递减 计数 模式 递增 计数 模式 
GPTMTnR GPTMTnILR 0x0 
GPTMTnV GPTMTnILR 0x0 
GPTMTnPS GPTMTnPR 0x0 
GPTMTnPV GPTMTnPR 0x0 








在 软件 写 GPTM 控制 寄存 器 (CPTMCTL) 的 TnEN 位 时 ， 使 能 定时 器 以 捕获 事件 。CCP 
引 脚 每 输入 一 个 事件 ， 计 数 器 的 值 就 递减 1， 直 到 事件 计数 的 值 与 GPTMTnMATCHR 和 
CPTMTnPMR 的 值 匹配 。 这 时 CPTM 将 让 CPTMRIS 寄存 器 确认 CaMRIS 位 〈 若 中 断 未 被 屏 
项， 可 同时 确认 CnMMIS 位 ) 。 

此 外 ， 它 还 可 以 产生 ADC 和 /或 pDMA 触发 。 在 达到 匹配 值 后 ， 计 数 器 将 使 用 CPTMT- 
nILR 和 CPTMTnPR 寄存 器 中 的 值 来 执行 重新 装载 操作 ， 并 由 CPTM 自动 将 GPTMCTL 寄存 
器 中 的 TnEN 位 清 零 ， 停 止 计 数 器 计数 。 一 旦 事件 计数 值 满 足 要 求 ， 随 后 的 所 有 事件 都 将 被 
忽略 ， 直 到 通过 软件 重新 将 TnEN 位 使 能 。 

例如 ， 计 数 需 配置 为 检测 输入 信和 号 的 双边 沿 ， 定 时 器 的 初 值 为 CPTMTnILR = 0x000A, 
匹配 值 为 GCPTMTnMATCHR = 0x0006。 此 时 ， 仅 需 计 数 四 个 边沿 事件 ， 如 图 11-3 所 示 。 

















定时 器 停止 ”定时 器 在 下 个 周期 
标志 已 生效 重新 加 载 忽略 忽略 


















0x0009 二 ------ 
0x0008 十 ----ーーー 
0x0007 十 -一 -一 -一 


有 


Ce al | 


图 11-3 输入 边沿 计数 模式 示例 


209 


(4) 输入 边沿 定时 模式 
在 边沿 定时 模式 中 ， 最 大 输入 频率 为 系统 频率 的 1/4 ， 定 时 器 配置 为 24 位 或 48 位 递增 
/递减 计数 模式 。 对 于 该 模式 ， 在 递减 计数 时 需 初 始 化 装载 值 到 GPTMTnILR 寄存 器 中 。 和 定时 
器 可 捕获 三 种 事件 类 型 : 上 升 治 、 下 降 沿 、 或 双 沿 。 通 过 置 位 CPTMTnMR 寄存 器 的 TnCMR 
位 可 将 定时 器 配置 为 边沿 定时 模式 ， 而 定时 器 捕获 时 采用 的 事件 类 型 可 由 GPTMCTL 寄存 器 
的 TnEVENT 字段 来 决定 。 表 11-6 列 出 了 输入 事件 计数 模式 的 计数 器 值 。 
表 11-6， 当 定时 器 使 能 时 输入 事件 计数 模式 的 计数 器 值 

















寄 存 器 递减 计数 模式 递增 计数 模式 
GPTMTnR GPTMTnILR 0x0 
GPTMTnV GPTMTnILR 0x0 
GPTMTnPS GPTMTnPR 0x0 
GPTMTnPV GPTMTnPR 0x0 








在 软件 写 GPTMCTL 寄存 器 中 的 TnEN 位 时 ， 可 使 能 定时 器 来 捕获 事件 。 在 检测 到 所 选 
输入 事件 时 ， 从 GPTMTnR 和 CPTMTnPS 寄存 器 中 捕获 定时 器 计数 器 的 当前 值 ， 且 该 值 可 通 
过 微 控制 器 来 读 取 。 然 后 CPTM 将 确认 CnERIS 位 (车 中 断 未 被 屏蔽 ， 可 同时 确认 CnEMIS 
位 ) 。 GPTMTnV 包含 定时 器 的 自由 运行 值 ， 读 取 该 值 可 以 确定 从 中 断 发 生 到 进入 中 断 处 理 程 
序 之 间 所 花费 的 时 间 。 

此 外 ， 它 还 可 产生 ADC 或 pDMA 触发 。 在 捕获 到 事件 之 后 ， 定 时 器 不 会 停止 计数 ， 而 
是 继续 计数 ， 直 到 TnEN 位 被 清 零 为 止 。 当 定时 器 达到 超时 值 时 ， 在 递增 模式 中 将 重新 装载 
0x0 ， 而 在 递减 模式 下 需 重 新 装载 来 自 GCPTMTnILR 寄存 器 中 的 初 值 。 

输入 边沿 定时 模式 的 工作 原理 如 图 11-4 所 示 。 假 设 定时 器 的 初 值 为 默认 值 0xFFFF, 定 
时 器 配置 为 捕获 上 升 沿 事件 。 每 当 检测 到 上 升 沿 事件 时 ， 当 前 计数 值 便 加 载 到 CPTMTnR 寄 
存 器 中 ， 该 值 将 一 直 保 持 到 在 寄存 器 中 检测 到 下 一 个 上 升 沿 〈 在 此 上 升 沿 处 ， 新 的 计数 值 
被 加 载 到 CPTMTnR 寄存 器 中 ) 。 











计数 コ _ ー 
OXEEEF GPTMTnR=X GPTMTnR=Y  GPTMTnR=Z 











ms 
图 11-4 输入 边沿 定时 模式 的 工作 原理 
(5) PWM 模式 
CPTM 支持 简单 的 PWM 生成 模式 。 在 PWM 模式 中 ， 将 定时 器 配置 为 24 位 或 48 位 递 
减 计 数 器 ， 初 值 由 GPTMTnILR 寄存 器 确定 。 在 此 模式 中 ，PWM 频率 和 周期 为 同步 事件 ， 以 
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保障 无 毛刺 现象 。 使 CPTMTnMR 寄存 器 中 的 TnAMS 位 =1、TnCMR 位 =0、TnMR 字段 =2 
即 可 使 能 PWM 模式 。 表 11-7 列 出 了 PWM 模式 的 计数 器 值 。 


表 11-7 当 定 时 器 使 能 时 在 PWM 模式 的 计数 器 值 















































寄 存 器 递减 计数 模式 递增 计数 模式 
GPTMTnR GPTMTnILR 不可 
GPTMTnV GPTMTnILR 不可 
GPTMTnPS GPTMTnPR 不可 
GPTMTnPV GPTMTnPR 不可 




















在 软件 写 GCPTMCTL 寄存 器 的 TnEN 位 时 ， 计 数 器 开始 递减 计数 ， 直 到 计数 值 到 达 0x0 
为 止 。 如 果 CPTMTnMR 寄存 器 中 的 TnWOT 位 置 位 ， 在 TnEN 位 置 位 时 ， 定 时 器 将 等 待 一 个 
触发 来 启动 计数 。 在 周期 模式 的 下 一 个 计数 循环 中 ， 计 数 器 会 将 其 初 值 重 新 装载 到 GPTMT- 
nILR 和 GPTMTnPR 寄存 器 中 ， 并 继续 计数 ， 直 到 用 户 通过 软件 将 GPTMCTL 寄存 器 中 的 
TnEN 位 清 零 禁止 计数 。 定 时 器 可 根据 上 升 沿 、 下 降 治 或 双 沿 这 三 种 事件 来 产生 中 断 。 事 件 
可 通过 CPTMCTL 寄存 器 中 的 TnEVENT 字段 来 配置 ， 而 中 断 可 通过 设置 CPTMTnMR 寄存 器 
中 的 TnPWMIE 位 来 使 能 。 在 发 生 该 事件 时 ， 将 使 GPTM 原始 中 断 状态 寄存 器 CGPTMRIS) 
中 的 CnERIS 位 置 位 ， 并 保持 该 值 直到 在 CPTM 中 断 清 除 寄 存 器 (GPTMICR) 中 执行 写 操 
作 使 之 清 零 为 止 。 大 在 GPTM 中 断 屏蔽 寄存 器 (CPTMIMR ) 中 使 能 捕获 事件 中 断 ，CGPTM 
还 会 将 CPTM 屏 藏 的 中 断 状态 寄存 器 (GPTMMIS) 中 的 CnEMIS 位 置 位 。 注 意 ， 这 里 中 断 
状态 位 不 会 被 更 新 ， 除 非 TnPWMIE 位 被 置 位 。 

当 计 数 器 的 值 与 GPTMTnILR 和 GPTMTnPR 寄存 器 的 值 〈 计 数 器 的 初始 状态 ) 相等 时 ， 
输出 PWM 信号 有 效 ， 当 计数 器 的 值 与 CPTMTauMATCHR 和 CPTMTnPMR 寄存 器 的 值 相等 
时 ， 输 出 PWM 信和 号 无 效 。 在 TaPWML 位 =1 的 条 件 下 ， 可 软件 实现 将 输出 PWM 信号 反 相 
的 功能 。 

例如 ， 假 设 初 值 为 CPTMTnILR = 0xC350， 匹 配 值 为 CPTMTnMATCHR = 0x411A, 如 
图 11-5 所 示 。 

说 明 : 从 图 11-5 中 可 以 看 到 当 递 减 计 数 器 的 计数 值 为 0 时 ， 将 重新 装载 初 值 (GPTMT- 
nILR =0xC350) ， 同 时 输出 的 PWM 信号 将 翻转 一 次 ; 当 计 数 器 的 值 等 于 设 定 的 匹配 值 
(GPTMTnMATCHR =0x411A) 时 也 将 翻转 一 次 。 通 过 合理 的 设置 初 值 和 匹配 值 的 大 小 可 获 
得 不 同 占 空 比 的 PWM 信号 。 

2. 等 待 触 发 模式 

等 待 触 发 模式 允许 使 用 菊花 链 式 的 定时 器 模块 。 若 进行 恰当 的 配置 ， 一 个 单独 的 定时 器 
可 使 用 定时 器 触发 来 初始 化 多 路 时 钟 事件 。 将 GPTMTnMR 寄存 器 中 的 TnWOT 位 置 位 来 使 
能 等 待 触 发 模式 。 在 TaWOT 位 置 位 时 ，Timer N +1 只 有 等 到 菊花 链 中 它 的 上 一 个 (Timer 
N) 达到 超时 事件 时 ， 才 会 开始 计数 。 菊 花 链 一 般 地 配置 形式 为 CPTM1 一 GPTM0O 、GPTM2 一 > 
GPTM1 等 。 如果 Timer A 在 32 位 模式 中 ， 将 触发 下 一 个 定时 器 模块 的 Timer A。 若 Timer A 
在 16 位 模式 下 ， 则 将 触发 同一 个 定时 器 模块 的 TimerB ， 而 在 下 一 个 模块 中 ，Timer B 将 会 触 
发 Timer A。 注意 : GPTMO 的 TAWOT 位 永远 不 会 置 位 。GPTMCFG 位 如 何 影 响 菊花 链 如 
图 11-6 所 示 。 
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计数 GPTMTnR=GPTMnMR GPTMTnR=GPTMnMR 





TnEN 置 位 | | 1 
TnPW ML=0 es 
输出 
信号 


TnPWML=1 | | | 


图 11-5 PWM 模式 示例 





GP 定时 器 N+1 


定时 器 BADC 触 发 
定时 器 A ADC 触 发 


定时 器 B ADC 触 发 
定时 器 A ADC 触 发 











图 11-6 定时 需 菊 花 链 


3. 同步 通用 定时 器 模块 

GPTM 同步 控制 寄存 器 (GPTMSYNC) 中 的 GPTMO 模块 可 用 于 所 选 定时 器 的 同步 计数 。 
设置 GPTMSYNC 寄存 器 中 的 位 使 相关 的 定时 器 用 于 处 理 超时 事件 的 动作 。 而 对 于 用 于 级 联 
模式 的 计时 器 ， 只 有 定时 器 A 中 的 位 须 在 CPTMSYNC 寄存 器 进行 设置 。 在 同步 计数 时 ， 对 
定时 器 的 超时 操作 ， 见 表 11-8。 


表 11-8 GPTM 模块 的 超时 操作 























模 式 计数 方向 超时 行为 
32 和 64 位 单 次 一 N/A 
递减 计数 值 = ILR 
32 和 64 位 周期 
递增 计数 值 =0 














272 












































模 式 计数 方向 超时 行为 
32 和 64 位 RTC 递增 计数 值 =0 
16 和 32 位 单 次 = N/A 
递减 计数 值 = ILR 
16 和 32 位 周期 
递增 计数 值 =0 
递减 计数 值 =ILR 
16 和 32 位 边沿 计数 
递增 计数 值 =0 
递减 计数 值 =ILR 
16 和 32 位 边沿 定时 
递增 计数 值 =0 
16 和 32 位 PWM 递减 计数 值 =ILR 
注 : 只 有 所 有 定时 需 使 用 相同 的 时 钟 源 ， 才 能 使 其 正常 工作 。 























4. DMA 操作 

每 个 定时 器 都 有 一 个 专用 的 DMA 通道 ， 并 且 还 可 为 LDMA 控制 器 提供 一 个 罕 发 型 的 
请 求 信 号 ， 它 在 定时 融 原 始 中 断 条 件 出 现时 就 会 产生 ，pDMA 传输 的 仲裁 个 数 应 和 每 次 定时 
器 事件 出 现时 需 传输 的 数据 单元 个 数 相同 ， 这 些 都 无 需要 其 他 特殊 的 设置 就 可 使 能 定时 器 用 
于 pDMA 操作。 





定时 需 的 API 可 分 成 3 个 函数 组 ; 

① 处 理 定时 器 的 配置 。 

② 处 理 定时 器 的 内 容 。 

@) 处 理 中 断 。 

详细 的 GPTM 固件 库 函 数 简 介 请 见 书 后 附录 。 


$ 11.3 例 程 


下 面 将 以 TI 提供 周期 定时 器 例 程 umers. c 为 例 来 介绍 通用 定时 器 固件 库 的 使 用 、 编 程 
及 测试 方法 。 

1. 基于 EK -TM4C123GXL 板 卡 的 周期 定时 器 例 程 测试 

1) 定时 器 例 程 电 路 连 线 图 ， 如 图 11-7 所 示 。 


2) timers. c 介绍。 








pp ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
//1 文 件 名 .timers. c 

// 1! 来源:TI 例 程 

// 1! 功能 描述 :该 例 程 介绍 了 如 何 使 用 定时 器 产生 周期 性 中 断 。 第 一 个 定时 器 设置 为 每 秒 

[AI 产生 一 次 中 断 , 第 二 个 定时 器 设置 为 每 秒 产生 两 次 中 断 ; 每 个 中 断 处 理 器 都 会 翻转 自己 
Z//! 的 指示 器 ,并 通过 虚拟 串 行 端口 在 “串口 助手 "PuTTY 上 显示 出 来 
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TM4C1236G 


图 11-7 
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定时 顺 例 程 电路 连 线 











// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 
#include 


#include 


<stdint.h > 

< stdbool. h > 
"inc/hw_ints. h" 
"inc/hw_memmap. h" 
"inc/hw_types. h" 

" driverlib/ debug. h" 

" driverlib/fpu. h" 

" driverlib/ gpio. h" 

" driverlib/interrupt. h" 
" driverlib/pin_map. h" 
" driverlib/rom. h" 

" driverlib/sysctl. hy" 

" driverlib/timer. h" 

" driverlib/uart. h" 
"utils/uartstdio. h" 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 








// 设 置 

















4 ユン Nl ト ーー よー 
个 全 局 变量 用 于 当前 中 断 状态 的 显示 标志 
// ネネ ネネ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 





uint32_t g_ui32Flags; 


// ネネ ネネ ネネ ポポ ネネ ポポ ボネ ポポ ポポ ボネ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ネネ ポポ ポポ 
~ N= ヽ Ne) 

// 发 生 固件 库 错 误 时 调用 此 错误 处 到 

// ネネ ボネ ネネ ポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


#ifdef DEBUG 


void 




















BE 例 程 











_ error_ (char * pcFilename ,uint32_t ui32Line ) 


#endif 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 
//[ 第 一 个 定时 顺 中 断 的 中 断 处 理 程 序 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ネギ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 








void 
TimerOIntHandler( void ) 
| 


char cOne ,cTwo: 


/ 
/清除 定时 器 中 断 
// 


ROM_TimerIntClear( TIMERO_BASE ,TIMER_TIMA_TIMEOUT) ; 


// 
// 反 转 第 一 个 计时 器 的 标志 
// 


HWREGBITW ( &g_ui32Flags,0) “=1; 





// 
// 使 用 显示 标志 来 反 转 定时 器 的 指示 LED 
// 


GPIOPinWrite( GPIO_PORTF_BASE, GPIO_PIN_1,g_ui32Flags < < 1); 


ノ // 

更新 PuTTY 上 的 中 断 状态 

// 

ROM_IntMasterDisable( ) ; 

cOne = HWREGBITW( &g_ui32Flags,0) 7 1 :0 

cTwo = HWREGBITW( &g_ui32Flags,1) 7 1:0; 
UARTprintf(" \rT1: %c T2: %c" ,cOne ,cTwo) ; 

ROM_IntMasterEnable( ) ; 





1 
) 


// ネネ ネネ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ 
//[ 第 二 个 定时 顺 中 断 的 中 断 处 理 程序 


// ネネ ネネ ネネ ポポ ネネ ポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 








void 
TimerlIntHandler( void ) 
| 


char cOne ,cTwo: 


// 
// 清 除 定 时 器 中 断 
// 


ROM_TimerIntClear( TIMER1_BASE,TIMER_TIMA_TIMEOUT) ; 


// 
// 反 转 第 二 个 计时 器 的 标志 
// 


HWREGBITW ( &g_ui32Flags,1) “=1; 


// 
215 





// 使 用 显示 标志 来 反 转 定时 器 的 指示 LED 
// 
CPIOPinWrite(CPIO_PORTF_BASE,GPIO_PIN_2,g ui32Flags < < 1); 


// 

更新 PuTTY 上 的 中 断 状态 

// 

ROM_IntMasterDisable( ) ; 

ceOne = HWREGBITW( &g_ui32Flags,0) 7 1 :0 
cTwo =HWRECBITW(&g ui32Flags,1) 7 1 :0 
UARTprintf(" \rT1: %c 12: %c" ,eOne ,cTwo) : 
ROM_IntMasterPnable( ) ; 





// ネネ ボネ ネネ ボ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ 


// 配 置 UART 与 相应 引 脚 


// ネネ ホネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ 




















void 
ConfigureUART( void ) 
| 
// 
// 使 能 用 于 UART 的 GPIO 外 设 
// 
ROM_SysCtIPeripheralEnable( SYSCTL_PERIPH_CPIOA ) ; 

















ZN 

// 使 能 UARTO 

XA 

ROM._ SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 





// 

// 将 GPIO 引 脚 配置 为 UART 模式 

// 

ROM_CPIOPinConfigure( CPIO_PA0_UORX ) ; 

ROM_CPIOPinConfigure( CPIO_PA1_UOTX ) ; 

ROM_CPIOPinTypeUART( CPIO_PORTA_BASE,GCPIO_PIN_0 | GPIO_PIN_1) : 














// 
// 使 用 内 部 16 MHz 振荡 需 作 为 UART 时 钟 源 
// 


UARTClockSourceSet( UARTO_BASE, UART_CLOCK_PIOSC) ; 





// 
// 初 始 化 UART 的 控制 台 IO 
// 


UARTStdioConfig(0,115200 ,16000000 ) ; 


// ネネ ボネ ネネ ポポ ポポ ポポ ボネ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ 


// 这 个 例 程 将 介绍 如 何 使 用 定时 器 来 产生 周期 性 中 断 
// ネネ ボネ ネネ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ 


int 
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main( void ) 
| 
// 
// 使 能 扩展 (lazy) 堆栈 的 中 断 处 理 程序 
// 这 可 使 浮 点 指令 用 于 中 断 处 理 程序 ,但 需要 使 用 额外 的 堆栈 空间 
4 
ROM_FPULazyStackingEnable( ) ; 









































// 

// 设 置 时 钟 直接 从 唱 振 (16 MHz ) 运行 

// 

ROM_SysCtlClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_16MHZ) : 





/ 
// 初 始 化 UART 和 写 状 态 
// 


ConfigureUART( ) ; 


UARTprint( " \033[ 2JTimers example\n" ) ; 
UARTprintf("T1:0 T2:0"); 


// 
// 使 能 LaunchPad 板 上 LED 的 GPIO 端口 






TM4C123G 








XA 
ROM._ SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOF) ; 
ROM_GPIOPinTypeGPIOOutput( GPIO_PORTF_BASE, GPIO_PIN 2 | GPIO_PIN_1) ; 





// 

// 使 能 TIMERO 与 TIMER1 使 用 的 外 设 

// 
ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_TIMERO ) ; 
ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_TIMERI ) ; 











// 使 能 处 理 器 中 断 
// 
ROM._ IntMasterEnable( ) ; 





// 
// 配 置 2 个 32 位 周期 定时 器 
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ノ / 
ROM_TimerConfigure( TIMERO_BASE,TIMER_CFG_PERTODIC) ; 
ROM_TimerConfigure( TIMERI_BASE,TIMER_CFG_PERTODIC) ; 


// 设 置 定时 器 0 的 装载 值 为 16M 次 , 即 运行 16M 次 所 花 的 时 间 为 1s 
ROM_TimerLoadSet( TIMERO_BASE,TIMER_A,ROM_SysCtlClockGet( ) ) ; 





// 设 置 定时 器 1 的 装载 值 为 8M 次 , 即 0.5s 
ROM_TimerLoadSet( TIMER1_BASE,TIMER_A,ROM_SysCtlClockGet( ) / 2) ; 





ン 
// 设 置 定时 器 0 与 定时 器 1 为 超时 中 断 

ン 

ROM_IntEnable(INT_TIMEROA) ; 
ROM_IntEnable(INT_TIMER1A ) ; 

ROM_TimerIntEnable( TIMERO_BASE,TIMER_TIMA_TIMEOUT) ; 
ROM_TimerIntEnable( TIMER1_BASE,TIMER_TIMA_ TIMEOUT) ; 


// 
// 使 能 定时 器 0 与 定时 器 1 

// 

ROM_TimerEnable( TIMERO_BASE, TIMER_A); 
ROM_TimerEnable( TIMER1_BASE, TIMER_A); 





2 
// 循 环 等 待 
// 

while(1) 

| 

| 





3) 创建 timer 工程, 添加 timer e 文件 ， 如 图 11-8 所 示 。 





而 
ws CCS Edit - timers/timers.c - Code Composer Studio | 


Se mer を | 田 i: や ゃ ママ ャ ィ 
取 Project Explorer “イル OTResource Explorer 8 回 *timers.c 


“timers [Active - Debug] 










































a II 


b 站; Binaries 142 // 这 个 倒 程 将 介绍 如 何 使 | 定时 时 
p 硬 mcludes 14 3 / /六 六 玉 闵 六 六 六 六 六 六 六 六 六 玉 闵 六 闵 六 闵 六 六 来 六 于 六 


b 区 Debug を nt j 


本 145 main(vod) 
b 区 utils 
展 ( 1azy ) 杜 二 
国 target_c "fg ml[ gl 


ROM ムク 


图 11-8 创建 的 timer 工程 




















b 回 startup_ccs.c 





















































pl 回 timers.c 


国 macros.ini_initia 





b | tImers_ccs.cmd 

















4) 编译 timer 工程 ， 并 将 其 下 载 到 EK - TM4C123CXL 开发 板 中 ， 如 图 11-9 所 示 。 





薄 Debug | 卖 中 | 区 SD 


- 本 





4 隊 timers [Code Composer Studio - Device Debugging] 


< 員 Stellaris In-Circuit Debug Interface_0/CORTEX_M4_0 (Suspended 


三 main() at timers.c:146 Ox00000458 


学 


三 _c_int00() at boot.asm:217 0x0000095E (Lc_int00 does not contaiy 


に 





图 11-9 将 编译 获得 的 . axf 可 执行 文件 下 载 到 EK - TM4C123GXL 板 中 





5) 测试 。 





gp COM7 - PuTTY 


① 打开 PuTTY 可 看 到 如 图 11-10 所 示 的 


信息 。 








说 明 : 从 图 11-10 T2 的 数字 








变化 速度 比 TIL 的 数字 变化 速度 快 一 倍 〔 读 者 可 图 11-10 在 PuTTY 中 显示 的 信息 


0 的 定时 器 超时 中 断 响应 是 否 为 1 s?)， 
一 次 中 断 、timerl 每 秒 产生 两 次 中 断 的 设计 要 求 。 








满足 timer0 每 秒 产生 


② 在 EK - TM4C123GXL 板 中 所 观察 到 的 测试 结果 : 首先 点 亮 的 是 蓝 色 LED 灯 (timerl 
连接 到 了 LED_ B， 11-7 和 表 11-1) ; 然后 点 亮 红 色 LED (timer0 连接 到 了 LED_ R, 
见 图 11-7 和 表 11-1) ;最 后 同时 点 亮 红 色 LED 和 蓝 色 LED 灯 。 这 是 因为 ，Timerl 每 秒 产 
生 两 次 定时 右 超 时 中 断 ， a 每 秒 仅 产 生 一 次 定时 圳 超时 中 断 ， 所 以 会 出現 忠信 LED 
被 首先 点 亮 (熄灭 ) 一 红色 LED 点 亮 一 红色 LED + 蓝 色 LED 同时 点 亮 的 现象 ， 这 就 进一步 





验证 了 上 述 程序 的 正确 性 
2. 基于 Proteus 的 周期 定时 器 例 程 timers 测试 
1) 周期 定时 器 timers 程序 。 





// ネネ ネネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ネネ 


// 文 件 名 : timers. c - Timers example 

// 来 源 :根据 TI 例 程 改编 

// 功 能 :周期 定时 带 

// 作 用 : 供 无 实际 板 卡 的 读者 测试 定时 器 程序 之 




















mmm 








// ネネ ネネ ネネ ポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポ ネ ポポ ポポ 


#include "inc/hw_ints. h" 
#include "inc/hw_memmap. h" 
#include "inc/hw_types. h" 
#include " driverlib/ debug. h" 
#include " driverlib/ gpio. h" 
#include " driverlib/interrupt. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/timer. h" 
#include " drivers/pdc. hy" 
#include " utils/uartstdio. hy" 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 


// 
// 如 果 驱 动 程序 库 遇 到 错误 将 调用 错误 处 理 程序 
A 
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ノノ 六 米 米 六 六 六 六 洲 米 六 六 六 六 六 米 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 六 
#ifdef DEBUG 
void 


error_ (char * pcFilename,unsigned long ulLine) 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 
// 

// 定 时 器 0 中 断 处 理 程序 

// 


// ネネ ネネ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 








void 
TimerOIntHandler( void ) 
| 
// 
// 清 除 中 断 
ノ // 
TimerIntClear( TIMERO_BASE,TIMER_TIMA_TIMEOUT) ; 
ノ // 
// 反 转 GPIO BO 
メ / 
GPIOPinWrite( CPIO_PORTB_BASE,GPIO_PIN_0, 
GPIOPinRead(GPIO_PORTB_BASE,GPIO_PIN_0) ^ GPIO_PIN_0) : 
| 


// ネネ ネネ ネネ ポポ ネネ ポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポ ネ ポポ ポポ 
// 

// 定 时 器 ] 中 断 处 理 程序 

// 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ネネ 








void 
TimerlIntHandler( void ) 
| 


// 

// 清 除 定时 器 中 断 

// 

TimerIntClear(TIMER1_BASE ,TIMER_TIMA_TIMEOUT) ; 
ン 

// 反 转 CPIO Bl 

// 


CPIOPinWrite( GPIO_PORTB_BASE, GPIO_PIN_1, 
CPIOPinRead( GPIO_PORTB_BASE, GPIO_PIN_1) “~ GPIO_PIN_1); 
| 
// ネネ ホネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ネネ ポポ ネネ 
// 
// 配 置 UARTO 用 于 信息 显示 
// 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ 


























void 


InitConsole( void ) 

| 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 
SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 
GPIOPinConfigure( GPIO_PAO_UORX) ; 
GPIOPinConfigure( GPIO_PA1_UOTX) ; 
GPIOPinTypeUART(CPIO_PORTA_BASE,CPIO_PIN_0 | GPIO_PIN_1) ; 
UARTSidioInit(0 ) ; 





| 


// ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホ ポポ ポポ ホホ ポポ ホホ ポポ ポ ホ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ 
// 

// 主 函数 

// 


// ネネ ネネ ネネ ポ ボネ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ 





int 
main( void ) 
| 
// 
// 设 置 系 统 时 钟 
// 
SysCHClockSet(SYSCTL_SYSDIV_1 | SYSCTL_USE_0SC | SYSCTL_O0SC_MAIN | 
SYSCTL_XTAL_6MHZ) ; 





// 

// 初 始 化 UART 及 打印 输出 信息 
ノ // 

InitConsole( ) ; 
UARTprintf(" VTimers example \n" ) ; 

UARTprintf( " \n" ); 

UARTprintf("T1 = SysClock = LED_Y\n" ) ; 

UARTprintf(" \T2 = (1/2)SysClock = LED_R\n" ) ; 

// 

// 使 能 所 用 的 外 设 

// 

SysCtlPeripheralEnable( SYSCTL_PERIPH_TIMERO ) : 
SysCtPeripheralEnable( SYSCTL_PERIPH_TIMER1 ) ; 
SysCLPeripheralEnable( SYSCTL_PERIPH_CPIOB) ; 

// 

// 使 能 处 理 器 中 断 

クタ 

IntMasterPnable( ) ; 

// 

// 将 GPIOB 端口 的 BO 和 Bl 设置 为 输出 引 脚 

// 

GPIOPinTypeGPIOOutput(GPIO_PORTB_BASE,CPIO_PIN_0 | GPIO_PIN_1) ; 
GPIOPinWrite( GPIO_PORTB_BASE, GPIO_PIN_0 | GPIO_PIN_1 ,0) ; 
// 

// 配 置 两 个 32 位 周期 定时 器 

// 
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TimerConfigure(TIMERO_BASE ,TIMER_CFC 32_BIT_PER ) ; 
TimerConfigure( TIMER1_BASE,TIMER_CFG_32_BTT_PER ) ; 
TimerLoadSet(TIMERO_BASE ,TIMER_A,SysCtlClockCet( ) ) ; 
TimerLoadSet(TIMERI_BASE,TIMER_A,SysCHClockCet( ) / 2) ; 
// 

// 设 置 定时 器 超时 中 断 

ジグ 

TntEnable( INT_TIMEROA) ; 

TntEnable( INT_TIMERIA) ; 

TimerIntEnable( TIMERO_BASE,TIMER_TIMA_TIMEOUT) ; 
TimerIntEnable( TIMER1_BASE,TIMER_TIMA_TIMEOUT) ; 
メ / 

// 使 能 定时 器 

KE 

TimerEnable( TIMERO_BASE, TIMER_A) ; 

TimerEnable( TIMER1_BASE, TIMER_A) ; 

4 

// 响 应 定时 器 中 断 

KL. 

while(1) 

| 

| 








| 


2) 搭建 周期 定时 融 程 序 的 测试 电路 ， 如 图 11-11 所 示 。 
说 明 : 如 果 给 出 的 测试 电路 不 能 运行 ， 请 先行 加 载 文件 夹 proteus_timers 中 的 timers. elf 
文件 5 
























Ximadem. Ymodem, zmodem 
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图 





11-11 周期 定时 器 程序 的 测试 电路 
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3) 测试 结果 如 图 11-12 所 示 。 





Timers example: 


RXD ト 一 Tl=SysClock=LED Y 
xn 上 T2= (1/2) SysClock=LED R 


WT VTHOD, ANEI | 


RTS | 





















































































CTS PE 
de | PAOUORX PDOIPWMO こら 
196 | FANUUOTX PDTIPWM1 [37 
nm | PAZSSICLK PD2 a 
| PAMSSIFSS 入 
D1 | BA4SSIRX PD | 机 
R1 mA | PASSSITX PsiCCP2 | 
Ha <n pBnicGPn PDEIFAULT 上 全 
300 トー キー トー PD7/Cho Ess 
LEB-YELLOW PED に 3 
R2 D2 T2 FE1 
ーー 全 ADc0 和 
LEB-RED 5 3 
PCUTCKISWCLK Anc3 ーー 
PCtITMSSWDIO 
PC2TDI 
PC3TDOSWO 
5 Do [ss 
PC5iC1sIC1o RST に っ 
FC8 oscn に 
PC7 Osc1 











LMsSsn1 
較 11-12 周期 定时 器 程序 测试 结果 


在 图 11-12 测试 电路 中 所 观察 到 的 现象 和 在 EK - TM4C123CXL 板 玉 中 的 現象 一 致 。 
说 明 ， 如果 给 出 的 测试 电路 不 能 运行 ， 请 先行 加 载 文 件 夹 proteus_timers 中 的 timers. elf 
文件 。 
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。。 第 』 ノ ョ の 


脉冲 宽度 调制 (PWM) 


脉冲 宽度 调制 (Pulse width modulation ，PWM) 是 一 项 常用 的 将 模拟 信号 电 平 进行 数字 
编码 的 技术 。 在 PWM 中 使 用 高 分 辩 率 计数 器 产生 方 波 ， 并 通过 调控 方 波 的 占 空 比 实现 对 模 
拟 信 号 的 编码 ， 其 典型 应 用 为 开关 电源 和 运动 控制 。 

TM4C123GH6PM 微 控制 器 包含 2 个 PWM 模块 ， 而 每 个 模块 又 包含 4 个 PWM 发 生 絮 和 

1 个 控制 模块 ， 共 16 路 PWM 输出 。 控 制 模块 决定 了 PWM 信号 的 极 性 及 哪 路 信号 传递 到 
引 脚 。 
每 个 PWM 发 生 器 模块 可 产生 2 路 PWM 信号 ， 这 两 路 信号 共享 同一 个 定时 器 和 频率 ， 
也 可 通过 编程 产生 独立 的 信号 ， 如 插入 死 区 延 时 的 互补 信号 。PWM 发 生 器 的 输出 信和 号 为 
pwmA' 和 pwmB'。 在 发 送 到 PWMO 、PWMI1 或 者 PWM2 以 及 PWM3 等 引 脚 之 前 ， 这 两 个 输 
出 信号 由 输出 控制 模块 管理 。 

TM4C123GH6PM PWM 模块 提供 大 的 灵活 性 ， 它 不 但 可 产生 简单 的 PWM 信号， 如 简易 
充电 泵 需要 的 信号 ; 而 且 可 产生 带 死 区 延迟 的 成 对 PWM 信号 , 如 半 - H 桥 驱 动 。3 个 发 生 
器 模块 也 可 产生 3 相反 相 器 桥 所 需 的 6 通 道 棚 概 控 制 信号 。 

此 驱动 程序 的 API 包含 在 driverlib/pwm. c 中 ， 而 driverlib/pwm. h 包含 了 应 用 程序 使 用 
的 API 的 定义 。 


本 章 的 主要 内 容 : 


> PWM 模块 
> PWM 固件 库 函 数 (请 见 书 后 附录 用 
> 例 程 




















PWM 的 主要 特点 


1) 每 个 PWM 发生 器 模块 具有 以 下 特点 . 

① 1 个 故障 条 件 处 理 输 入 ， 能 提供 快速 低 延迟 关闭 ， 可 防止 电动 机 在 被 控 前 损坏 ， 共 2 
个 输入 。 

@ 1 个 16 位 计数 器 。 
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e 运行 在 递减 或 先 递增 后 递减 模式 。 

e 输出 频率 由 一 个 16 位 的 装载 值 控制 。 

e 装载 值 可 同步 更 新 。 

e 在 零 和 装载 值 时 产生 输出 信和 号 。 

③ 两 个 PWM 比较 器 : 

e 比较 值 可 同步 更 新 。 

e 产生 匹配 输出 信号 。 

④ PWM 信和 号 发 生 器 : 

e 由 计数 结果 所 采取 的 行动 和 PWM 的 比较 右 输 出 信号 构建 PWM 的 输出 信号。 
e 产生 两 个 独立 的 PWM 信号 。 

⑤ 死 区 发 生 器 : 

e 产生 2 路 死 区 延迟 可 编程 的 PWM 信号 以 适合 驱动 半日 桥 。 

e 可 旁 路 ， 保 留 未 修改 的 输入 PWM 信号 。 

⑥ 可 以 启动 一 个 ADC 采样 序列 。 

2) PWM 控制 块 的 选项 如 下 : 

① 每 个 PWM 信号 的 PWM 输出 使 能 。 

② 每 个 PWM 信和 号 输出 的 反 相 选 择 〈 极 性 控制 ) 。 

@) 每 个 PWM 信号 的 故障 处 理 选择 。 
④ PWM 发 生 器 模块 的 定时 器 同步 。 

⑤ PWM 发 生 器 模块 间 的 定时 器 /比较 器 同步 更 新 。 

⑥ 扩展 PWM 发 生 器 模块 间 的 定时 器 /比较 器 同步 更 新 。 

CO PWM 发 生 器 模块 中 断 状态 汇总 。 

可 编程 极 性 和 过 滤 ， 扩 展 PWM 故障 处 理 多 个 故障 信号 。 
⑨ PWM 发 生 器 可 独立 操作 或 者 与 其 他 发 生 器 同步 操作 。 


PWM 的 模块 框图 


TM4C123GH6PM 控制 器 的 模块 框图 包含 两 个 PWM 模块 和 PWM 发 生 器 ， 分 别 如 图 12-1 
和 图 12-2 所 示 。 


信号 描述 
PWM 模块 的 外 部 信号 及 功能 描述 见 表 12-1。 
功能 简介 


1， 时 钟 配 置 

PWM 具有 两 个 可 选择 的 时 钟 源 : 
① 系统 时 钟 。 

②) 预 分 频 系 统 时 钟 。 
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PWM 时 钟 






PWMO 


pwmOfault 





系统 时 钟 





控制 与 状态 


PWMCTL 
PWMSYNC 
PWMSTATUS 


PWMPP 


pwmlfault 







PWMINTEN 
PWMRIS 
PWMISC 























較 12-1 PWM 模块 框图 




















ph 断 与 触发 


控制 


定时 器 
发 生 器 模块 pwm 故 障 














PWMnLOAD 
PWMnCOUNT 
死 区 发 生 器 
比较 器 
PWMnDBCTL 
PWM 时 钟 PWMnCMPA PWMnGENA PWMnDBRISE 


PWMnCMPB PWMnGENB PWMnDBFALL 








图 12-2 PWM 发 生 器 模块 框图 
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表 12-1 PWM 信号 (64LQFP) 
引 脚 名 引 脚 编号 | 引 脚 复 用 /赋值 | 引 脚 类 型 | 缓冲 器 类 型 描 述 
30 PF2 (4) 
MOFAULTO 53 PD6 (4) I TTL 运动 控制 模块 0 PWM 故障 0 
63 PD2 (4) 

MOPWMO 1 PB6 (4) 0 TIL a Me Ne 0 (该 信号 由 模块 0 
MOPWMI 4 PB7 (4) 0 TTL 有 人 PWM1 (该 信号 由 模块 0 

运动 控制 模 该 信号 由 模 
MOPWM2 58 PB4 (4) 0 TTL i | Se 2 (该 信号 由 模 泌 0 
MOPWM3 57 PB5 (4) 0 TTL の の 3 (该 信号 由 模块 0 
MOPWM4 59 PE4 (4) 0 四 i MM | ™ 4 (该 信号 由 模块 0 
MOPWM5 60 PES (4) 0 TTL 1 oe -0 5 (该 信号 由 模块 0 
MOPWM7 時 nl 0 TL 有 iM WW 7 (该 信号 由 模块 0 
MIFAULTO 5 PF4 (5) I TTL 运动 控制 模块 1 故障 0 

a RR 
MIPWMO 61 PDO (5) 0 TTL AA に | 本 0 (该 信号 由 模块 1 
MIPWMI 62 PD1 (5) 0 TTL Ss MM M ™ 1 (该 信号 由 模块 1 
MIPWM2 0 i の 6 2 (该 信号 由 模块 1 
MIPWM3 っ 6 > a a ww 3 (该 信号 由 模块 1 
MIPWM4 28 PFO (5) 0 TTL 上 We の J 4 (该 信号 由 模块 1 

运动 控制 模 该 信和 号 由 模 
MI1PWMS 29 PF1 (5) 0 TTL 了 人 5 (该 信号 由 模块 1 
MIPWM6 30 PF2 (5) 0 二 证 AH | 6 (该 信号 由 模块 1 
MIPWM7 31 PF3 (5) 0 TTL NN MN 7 (该 信号 由 模块 1 
































2. PWM 定时 器 

每 个 PWM 发 生 器 中 的 定时 器 要 么 运行 在 递减 模式 ， 要 么 运行 在 先 递增 后 递减 模式 。 在 
递减 模式 中 ， 定 时 器 从 装载 值 开 始 递减 计数 到 零 ， 然 后 返回 到 装载 值 ， 再 递减 计数 。 在 先 递 
增 后 递减 模式 中 ， 定 时 器 从 零 开始 计数 至 装载 值 ， 然 后 递减 到 0， 青 递增 到 装载 值 ， 循 环 往 
复 。 递 减 计数 模式 用 于 产生 左 或 右 对 齐 的 PWM 信号， 而 先 递增 后 递减 模式 用 于 产生 中 心 对 
齐 的 PWM 信号 。 

定时 器 输出 PWM 生成 过 程 中 所 使 用 的 三 个 信号 如 下 : 

① "dir" (方向 信号 ) 。 而 在 先 递增 后 递减 模式 中 ， 其 电 
平 在 低 、 高 之 间 切 换 。 
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② "zero" ( 零 脉冲 信号 ) 。 当 计数 器 的 计数 值 为 零 时 ， 零 脉冲 信号 将 产生 一 个 单 时 钟 周 
期 宽 的 高 电 平 脉冲 。 

③ "load" (装载 脉冲 ) 。 当 计数 器 的 计数 值 等 于 装载 值 时 ， 装 载 脉冲 将 产生 一 个 单 时 钟 
周期 宽 高 电 平 脉冲 。( 如 图 12-3、 图 12-4 所 示 ) 。 

注意 : 在 递减 计数 模式 中 ， 零 脉冲 后 面 紧 跟 着 装载 脉冲 。 

3. PWM 比较 器 

每 个 PWM 发 生 器 都 有 两 个 比较 器 ， 用 于 监控 计数 器 的 值 ， 当 比较 器 的 值 与 计数 器 的 值 
匹配 时 ， 比 较 器 输出 宽度 为 单 时 钟 周期 的 高 电 平 脉冲 ， 即 比较 器 输出 一 个 宽度 等 于 时 钟 周期 
的 高 电 平 脉 冲 ， 如 图 12-3 和 图 12-4 中 “cmpA” 与 “cmpB” 信 号 。 在 先 递增 后 递减 计数 
模式 中 ， 比 较 右 在 递增 和 递减 计数 时 都 需 进 行 比较 ， 因 此 必须 采用 计数 器 的 方向 信号 来 限定 。 
这 些 限定 脉冲 将 在 产生 PWM 信号 期 间 使 用 。 如 果 比 较 器 的 值 大 于 计数 器 的 装载 值 ， 那 么 这 个 
比较 器 将 永远 不 会 输出 高 电 平 脉冲 ， 图 12-3 显示 了 在 递减 计数 模式 时 的 行为 和 这 些 脉 冲 的 关 
系 。 图 12-4 给 出 了 在 先 递增 后 递减 计数 模式 下 计数 器 的 行为 和 这 些 脉 冲 之 间 的 关系 。 




















图 12-3 递减 计数 模式 





BUp | | BDown 
AUp ADown 


图 12-4” 先 递增 后 递减 计数 模式 
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4. PWM 信和 号 发 生 器 

PWM 发 生 需 捕获 load 、zero 、cmpA 和 cmpB 脉冲 ( 由 方 向 信号 限定 ) ， 产 生 两 个 PWM 
信号 (pwmA 和 pwmB ) 。 在 递减 计数 模式 中 ， 有 4 个 事件 可 影响 PWM 信和 号: 零 、 装 载 、 匹 
配 A 递减 、 匹 配 B 递减 。 在 先 递增 后 递减 计数 模式 中 ， 有 6 个 事件 可 影响 PWM 信号 : 零 、 
装载 、 匹 配 A 递减 、 匹 配 A 递增 、 匹 配 B 递减 、 匹 配 B 递增 。 当 匹配 A 或 匹配 B 事件 与 
零 或 装载 事件 一 臻 时， 它们 可 被 忽略 。 如 果 匹 配 A 与 匹配 B 事件 相 吻 合 ， 则 第 一 个 信和 号 
PWMA 仅 根据 匹配 A 事件 产生 ， 第 二 个 信号 pwmB 仅 根 据 匹配 B 事件 产生 。 

每 个 影响 PWM 输出 信号 的 事件 都 是 可 编程 的 : 可 被 保留 (忽略 该 事件 ) 、 可 被 翻转 、 
可 被 驱动 为 低 / 高 电 平 。 这 些 操作 可 用 于 产生 一 对 不 同位 置 和 占 空 比 的 PWM 信号 ， 且 该 对 
信和 号 既 可 重 县 也 可 不 重 琶 。 图 12-$ 给 出 了 在 先 递 增 后 递减 计数 模式 下 产生 的 一 对 中 心 对 
齐 、 含 有 不 同 占 空 比 的 重 友 PWM 信号 。 



































图 12-5 先 递 增 后 递减 模式 PWM 信号 发 生 图 例 
从 图 12-5 中 可 以 看 到 ， 第 一 个 PWM 发 生 吉 被 设置 为 当 发 生 匹 配 A 递增 事件 时 将 其 驱 
动 为 高 电 平 ， 发 生 匹配 A 递减 事件 时 使 其 为 低 电 平 ， 并 忽略 其 他 4 个 事件 。 第 二 个 发 生 器 
被 设置 为 当 发 生 匹配 B 递增 事件 时 将 其 驱动 为 高 电 平 ， 发 生 匹 配 B 递减 事件 时 使 其 为 低 电 











平 ， 并 忽略 其 他 4 个 事件 。 通 过 改变 比较 器 A 的 值 可 改变 pwmA 信号 的 占 空 比 ， 同 样 改 变 比 
较 器 B 的 值 也 可 改变 pwmB 信和 号 的 占 空 比 。 

5. 死 区 发 生 器 

PWM 发 生 器 产生 pwmA 和 pwmB 两 个 PWM 信号 并 传递 给 死 区 发 生 器 。 若 禁止 死 区 发 生 
器 ， 则 PWM 信号 只 简单 地 通过 该 模块 得 到 pwmA' 和 pwmB', WE 
而 不 会 发 生 改变 。 如 果 使 能 死 区 发 生 器 ,将 会 丢弃 pwmB 信 。 ”1!， | 
号 ， 仅 在 pwmA 信号 基础 上 产生 两 个 PWM 信号 。 第 一 个 输出 ”一 | 
PWM 信号 (pwmA') 为 pwmA 上 天 六 延 壕 可 编程 的 信号 。 第 ”| 一 一 
二 个 输出 PWM 信号 (pwmB') 与 pwmA 信号 反 相 ， 为 带 延 迟 上 升 沿 延 迟 “下降 沿 延迟 
时 间 可 编程 的 下 降 沿 延迟 信号 如 图 12-6 所 示 。 

6. 中 断 /ADC -触发 选择 器 

每 个 PWM 发 生 器 捕获 相同 的 4 个 〈 或 6 个 ) 计数 器 事件 来 产生 中 断 或 ADC 触发 事件 。 
可 选择 这 些 事件 中 的 任 一 个 或 一 组 作为 中 断 源 ， 只 要 所 选 定 的 事件 其 中 一 个 发 生 时 都 将 产生 
中 断 。 此 外 ， 也 可 选择 相同 事件 、 不 同事 件 、 一 组 相同 事件 、 一 组 不 同事 件 作为 ADC 的 触 
发 源 ， 当 这 些 选 定 的 任何 事件 发 生 时 同样 会 产生 ADC 触发 脉冲 。 选 择 的 事件 允许 在 pwmA 
或 pwmB 信号 内 的 特定 位 置 产 生 中 断 或 触发 ADC 转换 。 








图 12-6 PWM 死 区 发 生 器 
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7. 同步 方法 

常用 的 PWM 操作 如 下 : 

① 异步 : PWM 发 生 器 和 它 的 两 个 输出 信号 可 单独 使 用 ， 且 独立 于 其 他 PWM 发 生 器 。 

② 同步 PWM 发 生 器 和 它 的 两 个 输出 信号 共享 统一 的 时 基 与 其 他 PWM 发 生 器 连接 。 
如 果 多 个 PWM 发 生 需 都 配置 成 了 相同 的 计数 器 装载 值 ， 则 同步 可 保证 其 也 具有 相同 的 计数 
值 。 有 了 这 个 特性 ， 就 可 产生 两 个 以 上 的 PWMn 信号 ， 使 这 些 信 和 号 的 边沿 之 间 包含 某 些 已 
知 的 关系 ， 并 且 模 块 中 的 其 他 状态 也 提供 了 一 种 维持 共享 时 基 和 相互 同步 的 机 制 。 

若 向 PWM 时 间 基 准 同步 寄存 器 (PWMSYNC) 中 写 人 数据 ， 可 将 PWM 发 生 器 中 的 计数 
器 复位 ， 以 及 将 发 生 需 相关 的 SYNCn 位 置 位 。 并 可 在 一 次 访问 中 置 位 所 有 需要 的 SYNCn 位 
以 同步 多 个 PWM 发 生 器 。 例 如 ， 若 将 PWMSYNC 寄存 器 中 的 SYNCO 和 SYNC1 位 置 1 就 可 
使 PWM 发 生 器 0 和 PWM 发 生 器 1 中 的 计数 器 同时 复位 。 

8. 故障 状态 

故障 状态 时 必须 向 控制 器 发 出 停止 正常 PWM 功能 的 信号 ， 并 置 位 MnPWMn 信号 到 安全 
状态 。 两 种 基本 情况 将 会 引发 故障 状态 : 

① 微 控 制 器 被 中 止 且 在 运动 控制 中 不 能 及 时 执行 必要 的 计算 。 

② 检测 到 外 部 错误 或 事件 。 

每 个 PWM 发 生 器 可 用 下 面 的 输入 来 产生 故障 状态 : 

① MnFAULTn 引 脚 有 效 。 

② 由 调试 器 引发 的 控制 器 中 止 。 

③ ADC 数字 比较 器 的 触发 。 

故障 状态 的 计算 是 以 PWM 发 生 器 为 基础 的 。 每 个 PWM 秋生 閉 需 配置 必要 的 条件 来 指 
示 已 存在 的 故障 状态 ， 人 允许 开发 程序 可 独立 和 从 属 的 控制 。 

2 个 故障 输入 引 脚 (MnFAULTn) 可 供 选择 。 这 些 输入 可 用 于 和 产生 高 / 低 电 平 有 效 的 
电路 一 起 来 指示 一 个 错误 状态 。MnFAULTn 引 脚 可 使 用 PWMnFLTSEN 寄存 器 单独 编程 来 得 
到 适当 的 逻辑 意义 。 

PWM 发 后 器 的 控制 模式 ， 包 括 故 障 状态 处 理 ， 将 在 PWMnCTL 寄存 器 中 给 出 。 该 寄存 
器 决定 是 输入 信号 还 是 MnFAULTn 输入 信号 的 组 合 ， 和 /或 使 用 数字 比较 器 触发 来 产生 一 个 
故障 状态 。PWMnCTL 寄存 器 也 可 以 选择 故障 状态 是 维持 与 外 界 状态 一 样 长 ， 还 是 被 锁 存 直到 
由 软件 清除 故障 状态 为 止 。 最 后 ， 这 个 寄存 器 也 使 能 一 个 可 用 于 扩展 故障 状态 周期 的 计数 器 ， 
以 确保 外 部 事件 持续 时 间 最 短 。 该 最 小 故障 周期 计数 在 PWMnMINFLTPER 寄存 器 中 指定 。 

PWMnFLTSTATO 和 PWMnFLTSTAT1 寄存 器 提供 了 与 具体 故障 原因 相关 的 状态 。 
PWMINTEN 寄存 器 可 用 于 将 PWM 发 生 器 故障 状态 提升 为 控制 器 中 断 。 

9. 输出 控制 块 

在 pwmA' 与 bwmB' 作 为 MnPWMn 信号 到 达 引 脚 之 前 ， 输 出 控制 块 将 负责 对 其 进行 最 后 
的 调整 。 通 过 PWM 输出 使 能 寄存 器 ( PWMENABLE)， 可 对 实际 到 达 引 脚 上 的 一 组 PWM 
信号 进行 修改 。 例 如 ， 此 功能 可 用 于 执行 单个 寄存 器 的 写 操作 来 实现 跟 无 刷 直流 电动 机 的 通 
信 (无 需 修改 各 个 PWM 发 生 器 ， 只 需 对 反馈 控制 回路 的 进行 修改 ) 。 此 外 , 通过 PWM 更 新 
使 能 寄存 器 (PWMENUPD) ， 可 对 PWMENABLE 寄存 器 中 的 位 更 新 进行 配置 来 立即 、 局 部 ， 
或 全 局 同步 到 下 一 个 同步 更 新 。 
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故障 状态 期 间 ，PWM 输出 信号 MnPWMn， 通 常 必须 被 驱动 为 安全 值 ， 使 外 部 设备 可 以 
安全 地 控制 。PWMFAULT 寄存 器 指定 在 故障 状态 下 是 否 继续 驱动 已 产生 的 信号 或 在 PWM- 
FAULTVAL 寄存 器 中 一 个 指定 的 编码 。 

每 路 PWM 信和 号 都 有 可 配置 的 输出 反 向 控制 。 即 通过 PWM 输出 反 相 寄存 器 (PWMINVE- 
RT) 可 使 任何 MnPWMn 信号 反 相 ， 使 其 从 默认 的 高 电 平 有 效 变 成 低 电 平 有 效 。 即 使 某 值 在 
PWMFAULT 寄存 器 中 使 能 并 在 PWMFAULTVAL 寄存 器 中 指定 ， 仍 可 反 相 。 








PMW 固件 库 函 数 执行 PWM 模块 的 高 级 操作 。PWM 的 固件 函数 为 用 户 提 供 了 一 种 方 
法 ， 以 便 进行 PWM 模块 的 常见 配置 : 如 设置 周期 、 产 生 左 对 齐 和 中 心 对 齐 的 脉冲 、 修 改 
脉 宽 、 控 制 中 断 、 触 发 和 输出 特性 。PWM 模块 可 被 配置 成 多 种 不 同 的 形式 ， 但 有 些 形式 
已 超出 本 固件 库 的 范围 。 为 了 充分 利用 PWM 模块 的 特性 ， 建 议 读者 使 用 寄存 器 访问 宏 的 方 
式 实现 。 

PWM 固件 库 函 数 的 详细 介绍 请 参考 书后 附录 J。 














下 面 将 以 T 提供 的 pwm_invert e 程序 为 例 来 介绍 PWM 固件 库 的 使 用 、 编 程 及 测试 
方法 。 

1. 在 EK - TM4C123GXL 板子 上 测试 pwm_invert. c 程序 

1) PWM 例 程 硬件 连 线 图 如 图 12-7 所 示 。 


U1-A IGPIOi 








TM4C123G 


图 12-7 PWM 例 程 硬件 连 线 图 





2) pwm_invert. c 介绍 。 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


//! 文 件 名 :invert. c 





237 


232 


//! 来 源 : 根 据 TI 例 程 改编 

/A1 功 能 描述 : 

/A1 例 子 介 绍 了 如 何 设置 PWMO 使 用 其 反 向 输出 功能 
/A/! 此 功能 允许 反 转 PWM 的 输出 极 性 
// 1 该 例 程 将 一 个 25% 占 空 比 的 PWM 输出 每 隔 1s 反 相 一 次 ,以 得 到 75% 占 空 比 的 PWM 信号 
//!LaunchPad 板 上 LED_B(FP2 引 脚 ) 的 灯 每 秒 内 烁 1 次 来 指示 占 空 比 为 25% 与 75% 之 间 的 切换 
//1! 例 程 中 使 用 下 列 的 外 设 和 1/O 信号 : 

//1 - GPIOF 端口 (用 于 PWM 引 脚 ) 

//! -PWM6 -PF2 

//1 配 置 UART 信和 号 仅 用 于 在 PuTTY 上 显示 例 程 中 的 消息 
//1 -UARTO 外 设 

/A1 -GPIOA 端口 (用 于 UARTO 引 脚 ) 

//! ~ UARTORX -PAO 

//! - UARTOTX - PA1 

// 

メグ ホホ ポポ ホ ポポ ホネ ポ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホ ポポ ホホ ポポ ポポ ホホ ポ ホ ポ ホ ポポ ポ ホ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 
#include <stdbool. h > 

#include < stdint. h > 







































































#include "inc/hw_memmap. h" 
#include " driverlib/gpio. h" 
#include " driverlib/pin_map. h" 
#include " driverlib/ pwm. h" 
#include " driverlib/sysctl. h" 
#include " driverlib/uart. h" 
#include " utils/uartstdio. h" 

ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ: 
// 此 函数 设置 UARTO 的 控制 台 来 显示 该 例 程 运行 时 的 信息 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 











void 

InitConsole( void ) 

| 
// 
// 使 能 用 于 UARTO 引 脚 功能 的 GPIO 端口 A 
// 
SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 
// 
// 将 引 脚 复 用 端口 A0 和 Al 配置 为 UARTO 功能 
// 
GPIOPinConfigure( CPIO_PA0_UORX) : 
GPIOPinConfigure( CPIO_PA1_UOTX ) ; 





























// 

// 使 能 UARTO 以 便 后 续 配 置 时 钟 

// 

SysCtlPeripheralEnable(SYSCTL_PERIPH_UARTO ) ; 

XY 

// 使 用 内 部 16 MHz 振荡 器 作为 UART 时 钟 源 

// 

UARTClockSourceSet( UARTO_BASE ,UART_CLOCK_PIOSC ) ; 
と クス 








// 选 择 这 些 引 脚 的 (UART) 复 用 功能 

// 

GPIOPinTypeUART( GPIO_PORTA_BASE, GPIO_PIN_0 | GPIO_PIN_1); 
// 

// 初 始 化 UART 的 控制 台 IZO 

// 

UARTStdioConfig(0,115200 ,16000000) ; 











| 


// ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ホ ポ ホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ 
// 将 PWM6 配置 为 在 230 Hz 下 运行 的 占 空 比 为 25% 的 PWM 信号 , 以 及 毎 隔 $ s 反 相 一 次 输出 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





int 
main( void ) 
| 
// 
/设置 时 钟 直接 从 外 部 晶振 16 MHz 运行 
// 
SysCLClockSet( SYSCTL_SYSDIV_1 | SYSCTL_USE_OSC | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL _16MHZ) ; 





// 
// 设 置 PWM 时 钟 

// 

SysCtlIPWMClockSet( SYSCTL_PWMDIV_1) ; 
// 

// 设 置 串 行 控制 台 用 于 显示 消息 
// 

InitConsole( ) ; 

// 在 控制 台 上 的 显示 设置 
// 

UARTprintf(" PWM > \n" ) ; 
UARTprint(" 模块 : PWMI1\n" ) ; 
UARTprintf(" 引 脚 : PF2\n" ) ; 
UARTprintf(" 配置 占 空 比 : 25% % \n" ) ; 
U 

U 

U 





















































ARTprintf(" 反 相 占 空 比 : 75% % \n" ); 

ARTprintf(" 功能 : PWM 输出 每 隔 1s 反 相 一 次 . \n\n" ) ; 
ARTprintf(" 在 MIPWM6(PF2) 上 产生 PWM 信号 之 状态 ="), 
// 

// 使 能 PWM 外 设 

Xf 

SysCtlPeripheralEnable( SYSCTL_PERIPH_PWMI ) ; 

// 

// 使 能 CPIOF 端口 
// 
SysCLPeripheralPnable( SYSCTL_PERIPH_CPIOF ) ; 
メア 

// 将 复 用 引 脚 GPIO_PF2 配置 成 MIPWM6 功能 
// 
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CPIOPinConfigure( GPIO_PF2_MI1PWM6) ; 

// 

// 将 引 脚 PF2 配置 成 PWM 功能 

// 

GPIOPinTypePWM( GPIO_PORTF_BASE, GPIO_PIN_2); 

// 

// 将 PWM6 配置 为 异步 更 新 的 先 递增 后 递减 计数 模式 

// 

PWMGenConfigure( PWM1_BASE, PWM_GEN_1,PWM_GEN_MODE_UP_DOWN | 
PWM_GEN_MODE_NO_SYNC) ; 


























// 
// 设 置 PWM 周期 为 250 Hz 

// 计 数 公式 为 N = (1/f) SysClk 

// 其 中 ,N 为 函数 参数 ,f 为 所 需 的 频率 ,SysClk 为 系统 时 钟 频 率 
// 当 f=250 Hz 时,N = (1/250Hz ) x 16MHz =64000( 时钟 周 期 数 ) 
// 注 意 ,最 大 周期 应 设置 为 2^16 

// 

PWMCenPeriodSet(PWM1_BASE,PWM_CEN_0 ,64000 ) ; 

// 

// 设 置 PWM6 输出 的 占 空 比 为 25% 

// 

PWMPulseWidthSet( PWM1_BASE,PWM_OUT_6, 
PWMGenPeriodCet( PWM1_BASE,PWM_OUT_6)/4) ; 

2 
// 使 能 PWM6 位 6(PF2) 输 出 
// 
PWMOutputState( PWM1_BASE,PWM_OUT_6_BIT,rue) ; 
// 
// 使 能 PWM 发 生 器 模块 
// 
PWMCenEnable(PWM1_BASE,PWM_CEN_1) ; 
// 
// 无 限 循环 等 待产 生 PWM 信号 
// 

while(1) 

| 




































































// 

// 显 示 PWM 正常 输出 

だ 

UARTprintf( "Normal  \b\b\b\b\b\b\b\b" ) ; 
ZN 

// 延 时 1s 

// 计 数 公式 : 延 时 (时 钟 周期 数 ) =3 x 参数 
// 

SysCtDelay( (SysCtlClockGet( ) * 1)/3) : 

// 

//MIPWM6 信号 反 相 

// 

PWMOutputInvert( PWM1_BASE, PWM_OUT_6_BIT, true) ; 
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// 显 示 反 相 的 PWM 信和 号 


UARTprintf("Inverted\b\b\b\b\b\b\b\b" ) ; 

ノ // 

// 延 时 1s 

// 计 数 公式 : 延 时 (时 钟 周期 数 ) =3 x 参数 

// 

SysCtDelay( (SysCtlClockGet( ) * 1)/3); 

ノ // 

// 切 換 MIPWM6 信号 返回 正常 操作 

// 

PWMOutputlnvert( PWM1_BASE,PWM_OUT_6_BIT,false ) : 

















1 
1 


3) 创建 pwm_invert 工程 ,并 在 C:\ti\TivaWare_C_Series - 2.0.1.11577 \examples Vpe- 
ripherals\pwm 目录 下 导入 invert. c 文件 到 工程 中 ， 如 图 12-8 所 示 。 

4) 编译 pwm_ invert 工程 并 将 其 下 载 到 EK - TM4C123GXL 开发 板 中 。 

5) 测试 。 

① 打开 PuTTY， 其 显示 的 信息 如 图 12-9 所 示 。 




















sa CCS Edit - pwm_invert/invert.c - Code C 


Ee [TR ) 劳 名 ; 国 
iD Project Expro 号 


EE pwm_invert [Active - -psbug) 
六 ' BInaries 


| Includes 3 
PR 添加 的 
马 Debug 5 
invertc 文 件 
因 invert.c gp COM7 - PuTTY 


回 tm4c123gh6pm_startup_ccs.C 
tm4c123gh6pm.cmd 
回 uartstdio.c 
创建 的 pwm invert 
工程 | 















































图 12-8 创建 的 pwm_invert 工程 图 12-9 在 PuTTY 上 显示 的 程序 测试 结果 1 


了 JI 


息 


7 也 





从 图 12-9 中 可 以 看 到 ， 每 隔 1s PWM 输出 的 占 空 比 反 相 一 次 符合 对 程序 的 设计 要 求 。 

② 在 EK - TM4C123GXL 板 上 也 观察 到 了 蓝 色 LED 指示 灯 每 秒 闪烁 一 次 ， 进 一 步 验 证 
了 程序 功能 的 正确 性 ， 如 图 12-10 所 示 。 

说 明 : 有 兴趣 的 读者 可 以 用 示波器 观察 FP2 端口 输出 的 PWM 波 是 否 满足 要 求 的 占 空 
比 ， 以 及 它们 是 否 每 秒 反 相 一 次 。 没 有 示波器 的 读者 也 可 以 用 CCS 软件 画 波 形 图 的 功能 来 
查看 PWM 的 输出 是 否 满 足 设计 要 求 。 或 者 采用 Keil ARM 软件 的 逻辑 分 析 仪 来 分 析 PWM 输 
出 的 结果 ， 当 然 这 必 须 在 Keil ARM 中 新 建 一 个 pmw_invert 工程 。 

2. 在 Proteus 上 测试 pwm_invert. c 程序 

1) 搭建 pwm_invert. c 程序 的 测试 电路 ， 如 图 12-11 所 示 。 
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图 12-11 pwm_invert. c 程序 的 测试 电路 














2) pwm_invert c 程序 。 由 于 这 段 程序 和 上 面 所 介绍 的 pwm_invert c 程序 基本 相同 ， 不 
再 给 出 ， 需 要 注意 如 下 : 


// 
// 设 置 PWM 周期 为 250 Hz 

// 计 数 公式 为 :N = (1/f) x SysClk 

// 其 中 ,N 为 函数 参数 ,f 为 所 需 的 频率 ,SysClk 为 系统 时 钟 频率 
// 当 f=250 Hz 时 ,N = (1/250Hz) x6 MHz =24000( 时钟 周期 数 ) 
// 注 意 ,最 大 周期 应 设置 为 2%16 

// 

PWMCenPeriodSet( PWM_BASE,PWM_CEN_0,24000) ; 


3) pwm_invert. c 程序 的 测试 结果 如 图 12-12、 图 12-13 所 示 。 

从 图 12-12 中 可 以 看 到 ， 脉 冲 为 整个 周期 的 1/4， 通 过 调节 示波器 旋钮 让 波形 准确 地 对 
准 显示 器 中 的 网 格 ， 就 可 清晰 地 看 到 这 个 结果 ， 从 而 验证 程序 的 正确 性 。 同 时 LED 闪烁 较 
快 ， 这 是 因为 LED 的 导 通 时 间 相对 较 短 ， 因 此 感觉 LED 闪烁 较 快 。 

从 图 12-13 中 可 以 看 到 ， 脉 冲 为 整个 周期 的 3/4， 通 过 调节 示波器 旋钮 让 波形 准确 地 对 
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Configured Duty Cycle : 25$% 
Tnverted Duty Cyo1e: 75% 
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較 12-12 占 空 比 为 25% 时 的 测试 结果 























PWM 一 > 

Module : PWMO 

Bin: PDO 

ConFigured Duty Cycle: 25% 
Inverted Duty Cycle : 75% 
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占 空 比 75% 

















| LED 闪 烁 
较 慢 
























































較 12-13 占 空 比 为 75% 时 的 测试 结果 


























准 显示 器 中 的 网 格 ， 就 可 清晰 地 看 到 这 个 结果 ， 从 而 验证 程序 的 正确 性 。 同 时 LED 闪烁 较 
慢 ， 这 是 因为 LED 的 导 通 时 间 相 对 较 长 ， 因 此 感觉 LED 闪烁 较 慢 。 
对 于 那些 没有 板子 或 有 板子 但 资源 较 少 的 读者 ， 借 助 Proteus 提供 的 大 量 虚拟 工具 ,在 
学 习 编 程 或 项 目 开发 初期 不 失 为 一 种 有 效 的 方法 。 

本 小 节 程 序 见 配套 资源 第 12 章 内 容 ， 如 果 Pruteus 电路 不 能 运行 ， 要 先行 加 载 pwm_ 
invert elf 文件 。 
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。。 第 よう 章 。。 


微 直 接 存 储 器 访问 ( nDMA) 


直接 存储 需 访 问 (Direct Memory Access , DMA) ， 用 于 实现 设 备 与 存储 器 之 间 ， 以 及 存 
储 右 与 输入 /输出 端口 之 间 的 高 速 传输 ， 而 无 需 微 控制 器 的 干预 。 控 制 器 首先 必须 向 微 控制 
器 发 出 请 求 来 获取 系统 的 总 线 控制 器 ， 当 完成 传输 之 后 返还 系统 的 总 线 控 制 权 。 
DMATM4C123GH6PM 微 控制 器 包含 一 个 直接 存储 器 访问 控制 右 ， 被 称 为 微 DMA (pDMA) 。 
它 提供 的 工作 方式 可 分 流 Cortex -TM4C 处 理 右 的 数据 传输 任务 ， 从 而 可 更 有 效 地 利用 人 处 理 
器 和 可 用 的 总 线 带 宽 。kDMA 控制 器 能 自动 执行 存储 器 与 外 设 之 间 的 传输 。 每 个 文 持 片上 
MDMA 模块 的 外 设 都 有 其 专用 的 nDMA 通道 ， 通 过 合理 的 编程 配置 可 将 其 设置 为 自动 传输 
方式 ， 以 便 在 外 设 与 存储 器 之 间 高 效 的 传输 数据 。 

kDMA 的 API 提供 了 Tiva C uDMA 控制 吉 的 配置 郴 数 ， 用 于 与 ARM Cortex - TM4C 处 理 
器 一 起 工作 ， 并 为 系统 提供 高 效 与 低 开 销 的 数据 传输 模块 。 

该 驱动 程序 包含 在 driverlib/udma. c 中 ，driverlib/udma. h 包含 应 用 程序 使 用 的 API 定义 。 


本 章 的 主要 内 容 : 


> LDMA 模块 
と LDMA 宏和 库 函 数 ( 见 书 后 附录 K) 
> 例 程 























pDMA 的 特点 


MDMA 控制 带 有 具有 如 下 特点 : 

1) ARM PrimeCell 32 通道 可 配置 的 pDMA 控制 器 。 

2) 支持 存储 器 到 存储 器 、 存 储 器 到 外 设 、 外 设 到 存储 器 的 多 种 传输 模式 : 

① 用 于 简单 传输 场景 的 基本 模式 。 

② 用 于 连续 数据 流 的 乒乓 模式 。 

③ 按照 可 编程 的 任务 列表 ， 人 和 凭借 单个 请 求 触发 的 多 达 256 个 任意 传输 的 散 集 模式 。 
3) 高 度 灵 活 和 可 配置 的 通道 操作 : 

① 可 单独 配置 和 独立 操作 的 通道 。 

支持 片上 模块 的 专用 通道 。 
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@) 灵活 的 通道 分 配 。 

④ 给 双向 模块 的 每 个 接收 和 发 送 提供 单独 的 通道 。 

@) 可 软件 启动 传输 的 专用 通道 。 

⑥ 每 通道 都 可 配置 优先 级 方案 。 

《2 可 选 软件 启动 的 任意 通道 请 求 。 

4) 两 级 优先 级 。 

5) 采用 设 优 化 计 改善 了 gDMA 控制 器 与 处 理 器 内 核 之 间 的 总 线 访问 性 能 : 
① RDMA 控制 器 访问 是 从 属于 内 核 的 访问 。 

@ RAM 分 段 。 

@ 外 设 总 线 分 段 。 

6) 数据 宽度 为 8 位 、16 位 或 32 位 。 

7) 传输 数据 的 大 小 为 可 编程 的 二 进 制 步 ， 即 2 的 整数 寡 ， 其 范围 为 1 ~1024。 
8) 源 地 址 和 目的 地 址 增 量 大 小 为 字 节 、 半 字 、 字 或 没有 增 量 。 

9) 可 屏蔽 的 外 设 请 求 。 

10) 传输 完成 后 将 发 生 中 断 ， 每 通道 都 有 独立 的 中 断 。 


IDMA 模块 框图 
MDMA 模块 框图 如 图 13-1 所 示 。 
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图 13-1 puDMA 模块 框 





kDMA 控制 器 是 一 种 灵活 和 高 可 配置 的 DMA 控制 器 ， 被 设计 成 能 配合 Cortex - TM4C 处 
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理 器 的 内 核 工作 以 实现 高 效 的 数据 传输 。 它 支持 多 种 数据 宽度 与 地 址 递增 策略 ， 且 各 DMA 
通道 之 间 具 有 不 同 的 优先 级 和 多 种 传输 模式 ， 人 允许 复杂 的 可 编程 数据 传输 。RDMA 控制 器 占 
用 总 线 总 是 从 属于 处 理 器 内 核 ， 所 以 它 不 会 影响 到 处 理 器 的 总 线 事务 。 因 为 pDMA 控制 器 
只 占用 处 理 器 内 核 的 空 闪 总 线 周 期 ， 它 提供 的 数据 传输 带宽 基本 上 是 不 受 约束 的 ， 因 而 不 影 
响 系统 的 其 他 部 分 。 通 过 对 总 线 架构 的 优化 大 大 提升 了 处 理 器 内 核 和 RDMA 控制 器 有 效 地 
共享 片上 总 线 的 能 力 ， 从 而 提高 了 它 的 性 能 。 优 化 包括 RAM 分 段 和 外 设 总 线 分 段 ， 在 许多 
情况 下 ， 允 许 处 理 器 内 核心 和 wDMA 控制 器 同时 访问 总 线 并 进行 数据 传输 。 

kDMA 控制 絮 可 以 和 从 片上 SRAM 进行 双向 数据 传输 。 然 而 ， 由 于 闪存 和 ROM 都 位 于 
一 个 单独 的 内 部 总 线 ， 因 此 闪存 或 ROM 不 可 能 传输 数据 到 rkDMA 控制 器 中 。 

每 个 LDMA 控制 器 支持 的 外 设 功能 ， 都 有 一 个 可 被 独立 配置 的 专用 通道 。kDMA 控制 
器 使 用 在 系统 存储 器 中 由 处 理 器 维护 的 通道 控制 结构 体 ， 实 现 了 一 种 独特 的 配置 方法 。 不 但 
支持 简单 的 传输 模式 ， 而 且 它 也 可 以 在 存储 器 中 建立 复杂 的 “任务 ”列表 ， 人 允许 pDMA 控 
制 器 收 到 单 次 传输 请 求 后 ， 根 据 “ 任 务 列 表 ” 执 行 任意 大 小 的 数据 传输 和 接收 从 任意 位 置 
传送 过 来 的 数据 。MDMA 控制 器 还 支持 使 用 乒乓 缓冲 以 适应 与 外 设 的 双向 数据 流 。 

每 个 通道 还 可 配置 其 仲裁 大 小 ， 是 指 在 pwDMA 控制 器 重新 仲裁 通道 的 优先 级 之 前 ， 以 
突 发 方式 传送 的 项 目 数量 。 当 每 次 遇 到 一 个 pnDMA 服务 请 求 时 ， 根 据 配置 的 仲裁 数目 ， 可 
精准 控制 到 底 有 多 少 项 目 与 外 设 之 间 发 生 了 数据 传输 。 

1. 通道 分 配 

kDMA 控制 絮 通 道 分 配 见 表 13-1。 


表 13-1 pDMA 通道 分 配 








































































































Enc. 0 1 2 3 4 
Ch# 外 设 外 设 外 设 , 外 设 外 设 。 
0 USBO EP1 RX |SB UART2 RX SB 软件 B GPTimer 4A B 软件 B 
1 USBO EP1 TX |B UART2 TX SB 软件 B GPTimer 4B B 软件 B 
2 USBO EP2 RX |B GPTimer 3A B 软件 B 软件 B 软件 B 
3 USBO EP2 TX |B GPTimer 3B B 软件 B 软件 B 软件 B 
4 USBO EP3 RX |B GPTimer 2A B 软件 B GPIO A B 软件 B 
5 USBO EP3 TX |B GPTimer 2B B 软件 B GPIO B B 软件 B 
6 软件 B GPTimer 2A B UARTS RX SB CPIO C B 软件 B 
7 软件 B GPTimer 2B B UARTS TX SB CPIO D B 软件 B 
8 UARTO RX SB UARTI RX SB 软件 B GPTimer SA B 软件 B 
9 UARTO TX SB UARTI TX SB 软件 B GPTimer 5B B 软件 B 
10 SSIO RX SB SSIll RX SB UART6 RX SB| GPWideTimer OA |B 软件 B 
11 SSIO TX SB SSI1 TX SB UART6 TX SB| GPWideTimer OB | B 软件 B 
12 软件 B UART2 RX SB SSI2 RX SB| GPWideTimer 1A | B 软件 B 
13 软件 B UART2 TX SB SSI2 TX SB| GPWideTimer1B | B 软件 B 
14 ADCO SS0 B GPTimer 2A B SSI3 RX SB CPIO E B 软件 B 
15 ADCO SS1 B GPTimer 2B B SSI3 TX SB CPIO F B 软件 B 
16 ADCO SS2 B 软件 B UART3 RX SB| GPWideTimer 2A | B 软件 B 
17 ADCO SS3 B 软件 B UART3 TX SB| GPWideTimer2B | B 软件 B 





































































































Enc. 0 1 2 3 4 
Ch# 外 设 四 外 设 | 外 设 。 外 设 外 设 
18 GPTimer 0A B GPTimer 1A B UART4 RX SB CPIO B B 软件 B 
19 GPTimer 0B B GPTimer 1B B UART4 TX SB 软件 B 软件 B 
20 GPTimer 1A B 软件 B UART7 RX SB 软件 B 软件 B 
21 GPTimer 1B B 软件 B UART7 TX SB 软件 B 软件 B 
22 UARTI RX SB 软件 B 软件 B 软件 B 软件 B 
23 UARTI TX SB 软件 B 软件 B 软件 B 软件 B 
24 SSIl RX SB ADC1 SS0 B 软件 B | GPWideTimer 3A |B 软件 B 
25 SSI1 TX SB ADC1 SS1 B 软件 B | GPWideTimer 3B |B 软件 B 
26 软件 B ADC1 SS2 B 软件 B | GPWideTimer 4A |B 软件 B 
27 软件 B ADC1 SS3 B 软件 B | GPWideTimer 4B |B 软件 B 
28 软件 B 软件 B 软件 B | GPWideTimer SA |B 软件 B 
29 软件 B 软件 B 软件 B | GPWideTimer SB |B 软件 B 
30 软件 B 软件 B 软件 B 软件 B 软件 B 
31 保留 B 保留 B 保留 B 保留 B 保留 B 
注 : 1. S 为 单个 请 求 、B 为 突 发 请 求 、SB 为 单个 加 突 发 请 求 。 









































2， 表 中 注 明 “软件 ”的 通道 可 用 于 将 来 外 设 的 扩展 ， 这 些 通道 目前 仅 软件 可 访问 ， 不 可 连接 外 设 。30 号 通道 为 
软件 专用 通道 。 

2. 优先 级 

每 个 通道 pDMA 的 优先 级 由 通道 的 序号 和 通道 的 优先 级 标志 位 决定 。 第 0 号 uDMA 通 








道 的 优先 级 最 高 ， 通 道 的 序号 越 大 ， 反 而 其 优先 级 越 低 。 每 个 wDMA 通道 都 有 一 个 可 设置 
的 优先 级 标志 位 来 确定 其 优先 级 高 低 。 若 某 个 通道 的 优先 级 位 置 位 ， 则 该 通道 将 具有 高 优先 
级 ， 其 优先 于 所 有 未 将 此 标志 位 置 位 的 通道 。 假 如 有 多 个 通道 都 设 为 高 优先 级 ， 这 时 将 按 通 
道 序号 来 区 分 它们 的 优先 级 高 低 。 通 道 的 优先 级 位 可 通过 DMA 通道 优先 置 位 寄存 器 
(DMAPRIOSET) 置 位 ， 而 通过 DMA 通道 优先 清除 寄存 器 (DMAPRIOCLR) 清 零 。 

3. 仲裁 个 数 

当 某 个 LDMA 通道 请 求 传输 时 ，uDMA 控制 器 将 对 所 有 发 出 请 求 的 通道 进行 仲裁 ， 

且 只 向 优先 级 最 高 的 通道 提供 服务 。 一 旦 传输 开始 ， 首 先 将 持续 传输 一 定数 量 的 数据 之 后 
对 发 出 请 求 的 通道 进行 仲裁 。 每 个 通道 的 仲裁 个 数 都 是 可 设置 的 ， es 
條 項目 。 当 pDMA 控制 器 按照 仲裁 个 数 传输 了 若干 个 项 目 之 后 ， 随 后 将 检查 所 有 发 出 请 求 
的 通道 ， 并 只 向 优先 级 最 高 的 通道 提供 服务 。 

若 某 个 优先 级 较 低 的 nDMA 通道 仲裁 个 数 设 置 过 大 ， 可 能 使 高 优先 级 通道 的 传输 延迟 
增加 ， 这 是 因为 ，wDMA 控制 器 需要 等 待 低 优先 级 的 突 发 传输 完全 结束 之 后 才 会 重新 进行 促 
裁 ， 以 检查 是 否 存 在 更 高 优先 级 的 请 求 。 因 此 ， 建 议 对 于 低 优先 级 通道 的 仲裁 个 数 不 应 设置 
过 大 ， 以 充分 保障 系统 对 高 优先 级 DMA 通道 的 响应 速度 。 

4. 请 求 类 型 

kDMA 控制 右 可 用 于 响应 来 自 外 设 的 两 种 请 求 ， 单 次 请 求 或 突 发 请 求 。 每 种 外 设 可 支持 
其 中 一 种 或 两 种 类 型 ， 单 次 请 求 表 示 外 设 已 准备 好 传输 一 个 项 目 ， 而 突 发 请 求 则 表示 外 设 已 
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准备 好 传输 多 个 项 目 。 

根据 外 设 发 出 的 是 单 次 请 求 还 是 突 发 请 求 ，wDMA 控制 名 的 响应 也 会 有 所 不 同 。 假 设 
同时 发 出 了 单 次 请 求 和 突 发 请 求 ， 且 pDMA 通道 已 按 突 发 请 求 设 置 ， 则 会 优先 响应 突 发 请 
求 。 各 种 外 设 对 这 两 种 请 求 类 型 的 支持 见 表 13-2。 


表 13-2 支持 的 请 求 类 型 



























































外 设 产生 单个 请 求 的 事件 产生 突 发 请 求 的 事件 
ADC 无 FIFO 半 満 
通用 定时 器 无 触发 事件 
GPIO 原始 中 断 脉 冲 无 
SSI TX TX FIFO 不 满 TX FIFO 深度 ( 固定 4 级 ) 
SSI RX RX FIFO 非 空 RXFIFO 深度 (固定 4 级 ) 
UART TX TX FIFO 不 满 TXFIFO 深度 (可 配置 ) 
UART RX RX FIFO 非 空 RXFIFO 深度 (可 配置 ) 
USB TX 无 FIFO TXRDY 
USB RX 无 FIFO RXRDY 
5. 通道 配置 


RDMA 控制 器 采用 在 系统 内 存 中 保存 一 个 控制 表 ， 该 表 包 含 多 个 通道 控制 的 结构 体 ， 
而 每 个 DMA 通道 在 控制 表 中 可 能 有 一 个 或 两 个 结构 体 。 该 表 的 每 个 结构 体 都 包含 源 指针 、 
目的 指针 、 传 输 个 数 、 传 输 模 式 。 该 表 可 定义 到 系统 内 存 中 的 任意 连续 位 置 ， 并 按 1024 字 
节 边界 对 齐 。 

表 13-3 列 出 了 通道 控制 表 的 内 存 布局 。 结 构 体 由 主 控制 结构 体 和 副 控 制 结构 体 组 成 。 
在 控制 表 中 ， 所 有 主 控制 结构 体 都 在 表 的 前 半 部 分 ， 而 副 控制 结构 体 都 在 表 的 下 半 部 分 。 在 
较 简 单 的 传输 模式 中 ， 对 传输 的 连续 性 要 求 不 高 ， 允 许 在 每 次 传输 结束 后 再 重新 配置 、 重 新 
启动 。 这 种 情况 一 般 不 需要 副 控 制 结构 体 ， 因 此 内 存 中 只 需 放 置 表 的 前 半 部 分 即 可 ， 而 后 半 
部 分 所 占用 的 存储 空间 可 另 作 它 用 。 如 果 采 用 加 复杂 的 传输 模式 〈 如 乒乓 模式 或 散 聚 模 
式 ) ， 就 需要 用 到 副 控 制 结构 体 ， 此 时 整个 控制 表 都 必须 加 载 到 存储 器 中 。 

对 于 控制 表 中 任何 未 用 到 的 存储 块 都 可 留 给 应 用 程序 使 用 ， 包 括 任何 应 用 程序 未 用 的 通 
道 控制 结构 体 与 各 个 通道 中 未 用 到 的 控制 字 。 


表 13-3 控制 结构 体 存储 器 映射 





















































局 移 量 通 道 
0x0 0， 主 功能 
Ox10 1, 主 功能 
OxlFO 31, 主 功能 
0x200 0， 副 功能 
0x210 1, 副 功 能 
0x3F0 31， 副 功能 
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表 13-4 列 出 了 控制 表 中 单个 控制 结构 体 项 的 内 容 ， 并 按照 16 字 节 边界 对 齐 方式 。 每 
个 结构 体 项 由 4 个 长 整 型 项 组 成 : 源 末端 指针 、 目 的 末端 指针 、 控 制 字 与 一 个 未 用 的 长 整 
型 项 。 末 端 指针 是 指向 传输 过 程 最 末 一 个 单元 地 址 的 指针 (包含 其 本 身 ) 。 若 源 地 坪 或 目的 
地 址 无 需 自 动 递增 (如 外 设 寄存 器 ) ， 则 指针 应 当 指向 符 传 输 的 地 址 。 
表 13-4 通道 控制 结构 体 




















扁 移 量 描 ” 迷 
Ox000 源 未 端 指針 
Ox004 目标 末端 指针 
0x008 控制 字 
0x00C 未 使 用 





kDMA 控制 絮 在 传输 进行 时 会 自动 更 新 传输 大 小 字段 和 传输 模式 字段 。 在 传输 完成 之 
后 ， 会 使 传输 个 数 变 为 0， 传输 模式 变 为 “已 停止 ” 。 因 控制 字 是 由 pDMA 控制 器 自动 修改 
的 ， 则 在 每 次 新 建 传输 之 前 必须 手动 配置 ， 而 源 末 端 指针 和 目的 末端 指针 不 会 被 自动 修改 ， 
只 要 源 地 址 或 日 的 地 址 不 变 ， 就 无 需 再 度 配置 。 

在 启动 传输 之 前 ， 必 须 先 将 DMA 通道 使 能 设置 寄存 器 (DMAENASET) 中 的 相应 标志 
位 置 位 来 使 能 WDMA 通道 。 当 要 禁止 某 个 通道 时 ， 可 将 DMA 通道 使 能 清除 寄存 器 
(DMAENACLR) 中 的 相应 标志 位 置 位 即 可 ， 此 外 ， 在 某 个 通道 的 pDMA 传输 完成 后 ， 控 制 
器 将 自动 关闭 该 通道 。 

6. 传输 模式 

MDMA 控制 器 支持 多 种 传输 模式 ， 前 两 种 模式 支持 简单 的 单 次 传输 ， 而 后 几 种 模式 可 实 
现 持 续 数 据 传输 。 

(1) 停止 模式 

停止 模式 虽 为 控制 字 中 传输 模式 字段 的 有 效 值 ， 但 它 并 不 是 一 种 真正 的 传输 模式 。 当 控 
制 字 中 的 传输 模式 为 停止 模式 时 ，pDMA 控制 器 并 不 会 对 该 通道 进行 任何 传输 ， 而 一 旦 该 
通道 使 能 时 ，DMA 控制 器 还 将 自动 关闭 该 通道 。 在 任何 wDMA 传输 结束 后 ，kDMA 控制 
器 都 会 自动 将 通道 控制 字 的 传输 模式 字段 改 为 停止 模式 。 

(2) 基本 模式 

当 设 备 发 出 一 个 有 效 请 求 时 ，kDMA 控制 器 执行 简单 数据 传输 。 此 模式 用 于 在 外 设 发 出 
有 效 的 请 求 信号 后 ， 无 论 何 时 数据 都 将 被 传输 。 如 果 请 求 信 号 无 效 ， 无 论 是 否 传输 结束 都 将 
停止 传输 。 在 基本 模式 中 ， 当 所 有 项 目 传 输 结 束 后 ，kDMA 控制 器 会 自动 将 该 通道 置 为 停 
止 模式 。 

(3) 自动 请 求 模式 

执行 一 个 由 请 求 启 动 的 简单 传输 ， 即 使 请 求 被 撤回 ， 传 输 也 将 继续 进行 ， 直 到 完成 整个 
数据 传输 。 此 模式 适用 于 由 软件 启动 的 传输 。 

(4) 乒乓 模式 

该 模式 用 于 两 个 缓冲 器 之 间 的 数据 传输 ， 当 填充 每 个 缓冲 区 时 ， 可 从 一 个 缓冲 区 切换 到 另 
一 个 缓冲 区 。 虽 然 这 种 模式 可 确保 外 设 之 间 收 发 连续 的 数据 流 ， 但 需要 对 中 断 处 理 器 中 作 更 复 
杂 的 设置 ， 并 使 用 处 理 程序 来 管理 这 种 所 谓 的 乒乓 缓冲 器 。 一 个 该 类 型 的 示例 如 图 13-2 所 示 。 
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Primary Ctrl Struct Primary Ctrl Struct Buffers 
Ar A IID | wm 回 回 回 回 

SN 

完成 


Alternate Ctrl Struct 


当 副 控制 器 空闲 《或 正在 装载 准备 下 次 传输 ) 时 ， 主 控制 器 发 送 中 断 请 求 ， 表 示 它 的 这 次 传输 完成 
主 控制 器 正在 执行 传输 


Alternate Ctrl Struct 

















Primary Ctrl Struct Buffers Primary Ctrl Struct 
SE 四 加 四 加 四 加 四 加 
eo 


\ 完成 
Alternate Ctrl Struct | Alternate Ctrl Struct 5 


主 控制 器 装载 准备 下 次 传输 时 ， 副 控制 器 执行 传输 “ 副 控 制 器 发 送 中 断 请 求 ， 表 示 它 的 这 次 传输 完成 
重新 回 到 第 一 步 


图 13-2 乒乓 式 ADMA 数据 会 话 示 例 
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(5) 存储 器 散 聚 模式 

为 pDMA 控制 器 提供 建立 传输 “任务 ”列表 方法 的 一 种 复杂 模式 。 数 据 块 可 以 在 存储 
器 中 的 任意 存储 单元 进行 双向 传输 ， 存 储 器 散 聚 模式 是 一 种 较为 复杂 的 工作 模式 。 通 常 在 搬 
运 数据 块 时 ， 源 数据 和 目标 数据 都 是 按 线性 分 布 的 ;然而 有 时 必须 将 这 些 在 内 存 中 连续 分 布 
的 数据 分 散 传递 到 若干 个 不 同 的 存储 区 域 ， 或 将 内 存 中 几 个 不 同 存放 单元 的 数据 块 汇聚 传递 
到 同一 个 存储 区 域 连续 存放 ， 此 时 就 应 当 采 用 散 聚 模式 。 

在 存储 器 散 聚 模式 下 ， 主 控制 结构 体 是 按 内 存 中 一 个 表 的 内 容 来 配置 副 控制 结构 体 的 。 
该 表 由 处 理 器 软件 创建 ， 包 含 若 干 个 控制 结构 体 ， 每 个 控制 结构 体 中 又 包含 可 实现 特定 传输 
的 源 末 端 指针 、 目 的 末端 指针 、 控 制 字 。 在 每 个 控制 结构 体 的 控制 字 中 必须 将 传输 模式 设置 
为 散 聚 模式 。 主 传输 流程 依次 将 表 中 的 控制 结构 体 复制 到 副 控制 结构 体 中 ， 然 后 执行 。 
MDMA 控制 右 就 这 样 交替 切换 ， 即 每 次 用 主 控制 结构 体 从 列表 中 将 下 一 个 待 传输 的 流程 配 
置 复制 到 副 控制 结构 体 中 ， 再 切换 到 副 控制 结构 体 去 执行 相应 的 传输 任务 。 在 列表 的 最 末 一 
个 控制 结构 体 中 ， 应 将 其 控制 字 编 程 为 自动 传输 模式 。 因 此 当 执行 到 最 后 一 个 传输 过 程 时 为 
自动 模式 ，ADMA 控制 器 在 操作 完成 后 将 停止 该 通道 的 运行 。 仪 当 最 后 一 次 传输 过 程 也 结 
束 时 ， 才 会 发 出 结束 中 断 。 若 将 控制 表 最 后 一 个 控制 结构 体重 新 指向 列表 的 起 始 位 置 (或 
指向 一 个 新 的 列表 ) ， 将 使 整个 列表 处 于 循环 状态 。 

可 从 如 图 13-3、 图 13-4 所 示 的 例子 中 看 到 存储 需 散 聚 模式 的 工作 过 程 。 

在 图 13-4 中 ， 使 用 通道 的 主 控制 结构 体 ，RDMA 将 任务 A 的 配置 复制 到 通道 的 副 控 制 
结构 体 中 ， 然 后 pDMA 再 将 数据 从 源 缓冲 区 A 复制 到 目标 缓冲 区 中 。 ( 仅 以 任务 A 为 例 ， 
任务 B 与 C 工作 过 程 相同 ) 

7. 传输 个 数 及 增 量 

kDMA 控制 器 所 支持 的 传输 数据 宽度 为 8 位 、16 位 或 32 位 ， 对 于 任何 传输 ， 都 必须 保 
证 源 数据 与 目标 数据 的 宽度 相同 。 源 地 址 与 目标 地 址 可 以 按 字 节 、 半 字 或 字 自 动 递增 ， 也 可 
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存储 器 中 的 ei 存储 器 中 的 
源 和 目的 缓存 区 存 俏 吕 中 的 任务 列表 通道 控制 表 
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图 13-3 存储 器 散 聚 模式 (创建 及 配置 ) 


人 
FT 
































立 用 程序 需要 将 存储 器 中 三 个 不 同 存储 单元 的 若干 个 项 目 复 制 到 一 个 缓冲 区 中 并 顺序 组 合 。 















































1. 
2. 应 用 程序 在 存储 器 中 建立 PDMA“ 任 务 列表 ”， 表 中 包括 3 个 ADMA 控制 “任务 ”指针 与 控制 配置 。 
3. 应 用 程序 设置 通道 的 主 控制 结构 体 ， 将 任务 逐个 复制 到 副 控制 结构 体 中 ， 然 后 由 ADMA 控制 器 执行 。 
存储 器 中 的 存储 器 中 的 LDMA 存储 器 中 的 
任务 列表 控制 表 缓冲 区 























图 13-4 存 備 問 散 乗 模式 (uDMA 复制 序列 ) 





2 プ 5 





设置 为 非 自 动 递增 。 源 地 址 增 量 与 目标 地 址 增 量 无 关联 ， 其 设置 仅 要 求 保 证 其 大 于 等 于 数据 
宽度 即 可 。 

8. 外 设 接口 

如 果 某 个 外 设 支持 ADMA 功能 ， 则 在 它 准备 好 数据 传输 时 ， 可 发 出 一 个 单 次 请 求 信号 和 / 
或 一 个 突 发 请 求 信 号 。 请 求 信号 可 通过 DMA 通道 请 求 屏蔽 置 位 寄存 器 (DMAREQMASKSET) 
使 能 ， 并 通过 DMA 通道 请 求 屏蔽 清 零 位 寄存 器 (DMAREQMASKCLR) 来 禁止 。 奉 某 个 通道 
的 请 求 屏 蔽 位 置 位 ， 则 禁止 该 通道 的 pDMA 请 求 信 号 。 若 ADMA 通道 已 被 正确 配置 和 使 能 ， 
则 当 外 设 发 出 请 求 信号 时 ，kDMA 控制 器 将 启动 传输 过 程 。 当 kDMA 传输 结束 时 ，kDMA 控 
制 器 将 会 发 出 一 个 中 断 。 注 意 : 当 使 用 wDMA 与 外 设 进 行 数据 传输 时 ， 外 设 必须 禁止 所 有 
NVIC 中 的 中 断 。 

9. 软件 请 求 

在 32 个 ADMA 通道 中 有 一 个 专门 用 于 软件 启动 的 传输 通道 。 当 该 通道 pDMA 传输 完成 
时 ， 有 专用 的 中 断 予 以 指示 。 要 正确 使 用 软件 启动 的 wDMA 传输 ， 应 先行 配置 与 使 能 传输 
过 程 ， 然 后 通过 DMA 通道 软件 请 求 寄 存 器 (DMASWREO) 发 出 软件 请 求 。 注 意 ， 基 于 软件 
的 ADMA 传输 应 当 采 用 自动 传输 模式 。 

通过 DMASWREQ 寄存 器 也 可 以 启动 任意 通道 的 pDMA 传输 。 若 在 某 个 外 设 的 pDMA 通 
道上 使 用 软件 启动 请 求 ， 在 传输 完成 时 ， 结 束 中 断 将 在 该 外 设 的 中 断 向 量 处 发 生 ， 而 不 是 软件 
中 断 向 量 。 只 要 某 个 外 设 不 用 ADMA 做 数据 传输 ， 则 任何 外 设 通道 都 可 用 作 软 件 传输 请 求 。 

10. 中 断 与 错误 

当 某 个 LDMA 传输 过 程 结 束 时 ，pDMA 控制 器 将 在 相应 外 设 的 中 断 向 量 处 发 出 一 个 结 
東 中 断 。 因 此 , 若 某 介 外 設 使用 kDMA 传输 数据 时 ， 并 且 使 能 了 该 外 设 的 中 断 ， 则 在 中 断 
处 理 函 数 中 必须 包含 对 nDMA 传输 结束 时 的 中 断 处 理 。 如 果 传 输 过 程 使 用 了 软件 wDMA 通 
道 ， 则 结束 中 断 将 在 专用 软件 wDMA 中 断 向 量 上 产生 (見 表 13-5)。 

表 13-S pDMA 中 断 分 配 









































中 断 分 配 
46 RDMA 软件 通道 传输 中 断 
47 MDMA 错误 中 断 





当 使 能 某 外 设 的 ADMA 后 , pnDMA 控制 器 将 禁止 该 外 设 的 普通 传输 中 断 传递 到 中 断 控 
制 器 中， 但 该 中 断 的 状态 仍 可 在 外 设 的 中 断 寄存 器 中 查询 到 。 因 此 ， 当 使 用 wDMA 传输 大 
量 数据 时 ， 中 断 控 制 器 并 不 会 跟随 数据 流 从 外 设 频繁 地 接收 中 断 ， 而 是 仅 在 数据 传输 结束 时 
才 会 收 到 一 个 中 断 。 注 意 ， 未 屏 项 的 外 设 错误 中 断 仍 会 发 送 到 中 断 控 制 器 中 。 

当 LDMA 通道 发 出 一 个 完成 中 断 时 ， 在 DMA 通道 中 断 状态 寄存 器 (DMACHIS) 中 对 
应 该 通道 的 CHIS 位 将 置 位 。 外 设 中 断 处 理 代 码 也 可 通过 该 寄存 器 来 确定 中 断 是 由 kDMA 通 
道 产生 的 ， 还 是 由 外 设 中 断 寄存 器 上 报 的 出 错 事件 造成 的 。 当 中 断 处 理 程序 激活 后 ，hDMA 
控制 器 所 产生 的 结束 中 断 请 求 将 会 自动 清除 。 

若 LDMA 控制 器 在 尝试 进行 数据 传输 时 遇 到 了 总 线 或 存储 器 保护 错误 时 ， 将 会 自动 关 
闭 出 错 的 ADMA 通道 ， 并 在 DMA 错误 中 断 向 量 处 发 生 中 断 。 处 理 器 可 通过 读 取 DMA 总 线 
错误 清除 寄存 器 (DMAERRCLR) 来 确定 是 否 产 生 了 错误 中 断 。 一 旦 产生 错误 则 ERRCLR 
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标志 位 将 置 位 ， 可 向 ERRCLR 位 写 1 来 清除 错误 状态 。 





RDMA API 提供 了 一 组 用 于 配置 Tiva kDMA 控制 器 高 效 执行 DMA 传输 的 函数 。 设 置 和 
执行 DMA 传输 ， 一 般 的 函数 调用 顺序 如 下 : 

① rkDMAEnable( ) 。 被 调用 一 次 来 使 能 控制 器 。 

② pkDMAControlBaseSet( ) 。 被 调用 一 次 来 设置 通道 控制 表 。 

③ pkDMAChannelAttributeEnable( ) 。 被 调用 一 次 或 不 经 常 配 置 通道 的 行为 。 

④ rpDMAChannelControlSet( ) 。 用 于 设置 数据 传输 的 特性 。 如 果 数 据 传输 的 特性 不 变 ， 
仅 需 调用 该 函数 一 次 。 

⑤ nDMAChannelTransferSet( ) 。 用 于 设置 传输 的 缓冲 区 指针 和 大 小 。 需 在 新 的 传输 开始 

















前 调用 此 函数 。 

© rkDMAChannelEnable( ) 。 个 通道 用 于 执行 数据 传输 。 

@ ukDMAChannelRequest( ) 。 启动 一 个 基于 软件 的 传输 。 此 函数 通常 不 用 在 基于 外 
设 的 传输 中 。 


注意 : 控制 表 必 须 在 1024 字 节 边界 对 齐 。 
kDMA 控制 器 的 固件 库 函 数 由 两 部 分 组 成 : 定义 文档 和 函数 文档 。 
有 关 pDMA 固件 库 较 详细 的 函数 说 明 见 书后 附录 K。 


g 13.3 例 程 ーー ラニ 


本 小 








节 将 以 TI 提供 的 例 程 adma_demo 为 例 来 介绍 LDMA 国 件 库 的 使 用 及 编程 方法 。 


1) udma_demo. c 程序 说 明 。 


ノノ / 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 米 
//1 该 例 程 介绍 了 使 用 wDMA 控制 器 在 存储 器 之 间 传 输 数据 ,以 及 把 数据 传输 到 wpDMA 或 从 其 接 
/7/1! 收 数据 。 测 试 运行 10s 后 推出 
// ネネ ポポ ホネ ポポ ポポ ネ ポポ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネ ポポ ポポ ネネ ポポ ネネ 
// 包 含 文件 

… (省 略 , 见 配套 资源 第 13 章程 序 ) 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
//SysTick 中 断 毎秒 使用 SysTick 的 个 数 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
#define SYSTICKS_PER_SECOND 100 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
// 存 储 器 传输 的 源 和 目标 缓冲 区 的 大 小 ( 字 ) 
// ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ネネ ポ ネ ポポ ネ ポポ ポポ ネネ ポポ ネネ 
#define MEM_BUFFER_ SIZE 1024 
// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
//UART 发 送 和 接收 缓冲 区 的 大 小 
ノノ / ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネ ポ ポポ ネネ ポポ 


#define UART_TXBUF_SIZE 256 
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#define UART_RXBUF_SIZE 256 

ンク た キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギコ 
// 用 于 存储 器 传输 的 源 和 目标 缓冲 区 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ] 
static uint32_t g_ui32SrcBuf[ MKM_BUFFER_SIZE ] ; 

static uint32_t g_uni32DstBuf[ MEM_BUFFER_SIZE | ; 

ンク た キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギコ 
// 用 于 UART 传输 的 发 送 和 接收 缓冲 器 。 这 里 使 用 有 一 个 发 送 缓冲 区 和 一 对 接收 乒乓 缓冲 区 
ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ] 
static uint8_t g_ui8TxBuf[ UART_TXBUF_SIZE | ; 

static uint8_t g_ui8RxBufA[ UART_RXBUF_SIZE | : 

static uint8_t g_ui8RxBufB[| UART_RXBUF_SIZE ] ; 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ] 
//pDMA 的 错误 计数 ,其 值 由 kDMA 错误 处 理 器 递增 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ミキ] 
static unnt32_t g_uni32uDMAErrCount =0; 

ンク た キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギコ 
//pDMA 中 断 发 生 的 次 数 ,但 DMA 传输 并 未 完成 。 该 变量 应 该 保持 为 0 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ギコ 
static uint32_t g_ui32BadISR = 0; 

ンク た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ ミキ ギコ 
// 每 个 乒乓 缓冲 区 需 在 UART 缓冲 区 中 填充 的 个 数 

The count of UART buffers filled ,one for each ping - pong buffer. 

































































クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ : 
static uint32_t g_ui32RxBufACount =0: 
static unnt32_t g_ui32RxBufBCount = 0 ; 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ : 
//pDMA 传输 存储 器 块 计数 。 该 值 每 当 一 个 存储 器 块 传送 完成 将 由 pDMA 中 断 处 理 器 负责 递增 


// ネネ ボネ ネネ ポ ボネ ポポ ポポ ポポ ボネ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





static uint32_t g_ui32MemXferCount =0: 

ノノ 来 来 来 来 来 来 来 永 来 来 来 来 来 来 来 来 来 求 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 求 来 来 来 求 来 来 来 来 来 来 来 来 来 来 来 来 来 来 求 来 来 来 求 来 求 来 来 来 求 来 来 
//16. 16 定点 格式 的 CPU 使用 率 百 分 比 

ノノ 类 炒米 米 洲 求 洲 玉米 米 洲 米 米 米 米 沙洲 米 米 米 炒米 米 米 炒米 炒米 炒米 炒米 炒米 炒米 炒米 米 炒 炒米 米 米 炒米 米 米 米 玉米 炒米 玉米 玉米 米 洲 玉米 米 米 炒米 炒米 米 炒 
static uint32_t g_ui32CPUUsage ; 

ノノ 类 求 洲 米 洲 米 洲 米 米 米 洲 米 米 米 米 沙洲 炒米 米 米 洲 米 米 米 洲 米 米 米 炒米 米 米 米 玉米 玉米 米 米 炒米 米 米 洲 求 米 米 米 米 米 玉米 玉米 炒米 米 洲 玉米 米 米 炒米 炒米 米 炒 
// 程 序 开始 所 花费 的 秒 数 ,这 个 值 由 SysTick 中 断 处 理 程序 维护 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ 











static uint32_t g_ui32Seconds =0; 

ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そ そそ キネ: 
// 所 使用 的 pDMA 控制 器 的 控制 表 , 此 表 必 须 在 1024 字 节 边界 对 齐 

クキ キキ キキ ギ ギ キキ キキ キキ キキ キキ テキ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そ そそ : 
#1f defined( ewarm ) 

#pragma data_alignment =1024 

uint8 t ui8ControlTable[ 1024 ] : 

#elif defined( ccs ) 

#pragma DATA_ALIGN( ui8ControlTable ,1024 ) 

uint8_t nui8ControlTable| 1024 ] ; 

#else 


uint8_t nui8ControlTable| 1024 ] _attmibute_ ((aligned(1024 ) ) ) ; 























#endif 


void 

SysTickHandler( void ) 

| 
static uint32_t ui32TickCount =0: 
// 递 增 节 拍 计数 需 
ui32TickCount ++ ; 
// 如 果 发 生 每 秒 的 节拍 数 , 则 递增 秒 计数 器 
if(1(m32TickCount % SYSTICKS_PER_SECOND ) ) 
| 





g_ui32Seconds ++ ; 
| 
// 调 用 CPU 使 用 率 滴答 函数 
g_ui32CPUUsage = CPUUsageTick( ) ; 


1 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ボボ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポ 


//pDMA 错误 的 中 断 处 理 程序 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポ ネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 








void 
uDMAErrorHandler( void ) 
| 
uint32_t ui32Status ; 
// 检 查 uDMA 错误 位 
ui32Status =ROM_uDMAErrorStatusCet( ) ; 
// 如 果 有 一 个 ADMA 错误 , 则 清除 错误 并 将 错误 计数 器 加 1 
if(ui32Status ) 
| 





ROM_uDMAErrorStatusClear( ) ; 
g_ui32uDMAErrCount ++ ; 


| 


ノノ 水 玉米 炒米 洲 米 沙洲 炒米 米 米 炒米 炒米 炒米 炒米 炒米 米 沙 米 炒米 炒米 玉米 炒米 炒米 炒米 米 米 炒米 米 米 炒米 炒米 玉米 米 米 炒米 玉米 炒米 炒米 米 洲 米 炒米 炒米 炒米 
// 存 储 器 通道 的 pDMA 中 断 处 理 程序 。 这 个 中 断 将 使 计数 器 加 1 ,然后 重新 启动 另 一 个 存储 器 传输 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 














void 
uDMAIntHandler( void ) 
| 
uint32_t ui32Mode; 
// 检 查 主 控 制 结构 来 指示 完成 
ui32Mode = ROM_uDMAChannelModeGet( UDMA_CHANNEL_SW ) : 
if(ui32Mode == UDMA_MODE_STOP) 
| 





// 传 输 完成 计数 值 加 1 

g_ui32MemXferCount ++ ; 

// 配 置 男 一 个 传输 

ROM_uDMAChannelTransferSet( UDMA_CHANNEL_SW ,UDMA_MODE_AUTO, 
g_u132SrcBuf,g_un32DstBuf, 
MEM_BUFEFER_SIZE ) ; 
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| 


// 启 动 男 一 个 传输 
ROM_uDMAChannelEnable( UDMA_CHANNEL_SW ) : 
ROM_uDMAChannelRequest( UDMA_CHANNEL_SW ) ; 
| 
// 如 果 通 道 不 停止 , 则 存在 错误 
else 


| 





g_ui32BadISR ++ ; 


// ホネ ネネ ポポ ポポ ポポ ネネ ボボ ポポ ボボ ポポ ポポ ボネ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ 


//UARTI 中 断 处 理 程序 


// ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


void 


UART1IntHandler( void ) 


| 


uint32_t ui32Status; 
uint32_t ui32Mode; 
// 读 UART 的 中 断 状态 
ui32Status =ROM_UARTIntStatus( UART1_BASE,1 ) ; 
/清除 任何 挂 起 状态 
ROM_UARTIntClear( UART1_BASE ,ui32Status ) ; 
// 检 查 DMA 控制 表 , 以 查看 乒乓 “A” 传 输 是 否 完成 。“A” 传 输 使 用 了 接收 缓冲 区 “A”, 及 主 
// 控 制 结构 
ui32Mode = ROM_uDMAChannelModeGet( UDMA_CHANNEL_UARTIRX | UDMA_PRI_SELECT) ; 
// 如 果 主 控制 结构 指示 停止 , 则 “ A” 接收 缓冲 区 完成 。LDMA 控制 右 将 进入 “B” 的 缓冲 区 继 
// 续 接收 数据 
if(ui32Mode == UDMA_MODE_STOP) 
| 



































UD 





/人 /计数 器 加 1 来 指示 数据 已 接收 到 缓冲 区 A 
g_ui32RxBufACount ++ ; 
// 使 用 主 控 制 结构 给 “A” 的 缓冲 区 设置 下 一 次 传输 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_UARTIRX | UDMA_PRI_SELECT, 
UDMA_MODE_PINGPONG, 
(void * ) (UARTI1_BASE + UART_O_DR) , 
g_ui8RxBufA ,sizeof( g_ui8RxBufA ) ) ; 











| 

// 检 查 DMA 控制 表 , 以 查看 乒乓 “B” 传 输 是 否 完成 。“B” 传 输 使 用 了 接收 缓冲 区 “B”, 及 备 
// 用 控制 结构 

ui32Mode =ROM_uDMAChannelModeCet(UDMA_CHANNEL_UARTIRX | UDMA_ALT_SELECT) ; 
// 如 果 备 用 控制 结构 指示 停止 , 则 “B” 接 收 缓冲 区 完成 。phDMA 控制 器 将 进入 “A” 的 缓冲 区 
// 继 续 接 收 数据 

if(ui32Mode == UDMA_MODE_STOP) 

| 





















































UD 


// 计 数 器 加 1 来 指示 数据 已 接收 到 缓冲 区 A 
g_ui32RxBufBCount ++ ; 

// 使 用 备用 控制 结构 给 “B” 的 缓冲 区 设置 下 一 次 传输 
ROM_uDMAChannelTransferSet(UDMA_CHANNEL_UARTIRX | UDMA_ALT_SELECT, 


























| 


UDMA_MODE_PINGPONG, 
(void * )(UART1_BASE+UART 0_DR) , 
g_ui8RxBufB ,sizeof(g_ui8RxBufB ) ) ; 

| 

// 如 果 UART1 TX DMA 通道 被 禁止 , 则 TX DMA 传输 完成 

if( IROM_uDMAChannellsEnabled( UDMA_CHANNEL UARTI1TX)) 

| 





// 启 动 男 一 个 到 UARTI TX 的 DMA 传输 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_UARTITX | UDMA_PRI_SELECT, 
UDMA_MODE_BASIC,g_ui8TxBuf, 
(void * )(UARTI_BASE+UART_ 0_DR) ， 
sizeof(g_ui8TxBuf) ) ; 
//uDMA TX 通道 必须 被 重新 使 能 
ROM_uDMAChannelEnable( UDMA_CHANNEL_UARTITX ) : 





// ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
// 初 始 化 UART1 外 设 并 设置 TX 和 RX nuDMA 通道 。UART 配置 为 回环 模式 ,使 发 送 的 任何 数据 
// 将 在 RX 接收 。uDMA 通道 被 配置 成 在 TX 通道 将 缓冲 区 中 的 数据 复制 到 UART TX 输出 。 而 
//pDMA RX 通道 将 接收 到 的 任何 输入 数据 存放 到 一 对 乒乓 模式 的 缓冲 区 中 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ネネ ポポ 


void 






















































































InitUART1Transfer( void ) 


| 


unsigned int uldx: 

// 用 简单 的 数据 模式 填充 TX 缓冲 区 

for( uldx =0; uldx <UART_TXBUF_SIZE; uldx ++ ) 
| 

















g_ui8TxBuf| uldx | = uldx; 

| 
// 启 用 UART 外 设 ,并 将 其 配置 为 运行 即使 CPU 处 于 睡眠 
ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTI ) ; 
ROM_SysCtlPeripheralSleepEnable(SYSCTL_PERIPH_UARTI1 ) ; 
// 配 置 UART 的 通信 参数 
ROM_UARTConfigSetExpClk ( UART1_BASE, ROM_SysCtlClockGet( ) ,115200, 

UART_CONFIG_WLEN_8 | UART_CONFIG_STOP_ONE | 
UART_CONFIG_PAR_NONE ) ; 

// 设 置 TX 和 RX 的 FIFO 深度 都 为 4 
ROM_UARTFIFOLevelSet( UART1_BASE,UART_FIFO_TX4 8,UART_FIFO_RX4 8); 
// 使 能 UART 操作 ,并 使 能 TX 和 RX 通道 的 pDMA 接口 
ROM_UARTEnable(UART1_BASE ) ; 
ROM_UARTDMAEnable(UART1_BASE,UART_DMA_RX | UART_DMA_TX): 
/寄存器 写 将 设置 UART 在 回环 模式 下 运行 。 发 送 到 TX 输出 的 任何 数据 将 在 RX 输入 接收 
HWREC(UART1_BASE+UART_O_CTL)1=UART_CTL_LBE: 
// 使 能 UART 外 設 中 断 
ROM_IntPnable(INT_UART1 ) ; 

// 禁 止 pwDMA UARTIRX 通道 的 属性 设置 
ROM_uDMAChannelAttrbuteDisable( UDMA_CHANNEL_UART1RX ， 
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UDMA_ATTR_ALTSELECT | UDMA_ATTR_USEBURST | 
UDMA_ATTR_HIGH_PRIORITY | 
UDMA_ATTR_REOMASK) ; 
// 在 UART RX 通道 给 主 控制 结构 配置 控制 参数 
A UDMA_CHANNEL_UARTIRX | UDMA_PRI_SELECT, 
UDMA_SIZE_ 8 | UDMA_SRC_INC_NONE | UDMA_DST_INC_8 | 
UDMA_ARB 4) ; 
// 在 UART RX 通道 给 备用 控制 结构 配置 控制 参数 
We UDMA_CHANNEL_UARTIRX | UDMA_ALT_SELECT, 
UDMA_SIZE_8 | UDMA_SRC_INC_NONE | UDMA_DST_INC_8 | 
UDMA_ARB 4) ; 
// 设 置 UART RX 主 控制 结构 中 的 传输 参数 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_UARTIRX | UDMA_PRI_SELECT, 
UDMA_MODE_PINGPONG, 
(void * )(UARTI_BASE+UART 0_DR) , 
g_ui8RxBufA ,sizeof(g_ui8RxBufA ) ) ; 
// 设 置 UART RX 备用 控制 结构 中 的 传输 参数 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_UARTIRX | UDMA_ALT_SELECT, 
UDMA_MODE_PINCPONGC, 
(void * )(UARTI_BASE+UART 0_DR) , 
g_uiSRxBufB ,sizeof(g_ui8RxBufB ) ) : 
// 禁 止 pwDMA UARTITX 通道 的 属性 设置 
ROM_uDMAChannelAttributeDisable( UDMA_CHANNEL_UARTITX ， 
UDMA_ATTR_ALTSELECT | 
UDMA_ATTR_HIGH_PRIORITY | 
UDMA_ATTR_REOMASK) ; 
// 使 能 ruDMA UART1TX 通道 的 属性 设置 
ROM_uDMAChannelAttibuteEnable( UDMA_CHANNEL_UARTITX,UDMA_ATTR_USEBURST) ; 
// 配 置 UART TX 的 控制 参数 
ROM_uDMAChannelControlSet( UDMA_CHANNEL_UARTITX | UDMA_PRI_SELECT, 
UDMA_SIZE_ 8 | UDMA_SRC_INC_8 | UDMA_DST_INC_NONE | 
UDMA_ARB_4); 
// 设 置 为 LDMA UART TX 通道 的 传输 参数 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_UARTITX | UDMA_PRI_SELECT, 
UDMA_MODE_BASIC,g_ui8TxBuf, 
(void * )(UARTI_BASE+UART 0_DR) , 
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百 




















sizeof(g_ui8TxBuf) ) ; 

// 使 能 WDMA UART TX 和 RX 通道 ,此 时 pDMA UART TX 和 RX 通道 都 准备 开始 传输 
ROM_uDMAChannelEnable( UDMA_CHANNEL_UARTIRX) ; 

ROM_uDMAChannelEnable( UDMA_CHANNEL_UARTITX) ; 





























| 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


// 初 始 化 LDMA 软件 通道 以 执行 存储 器 到 存储 器 的 pDMA 传输 


// * ま ※※ ネ ポポ ポポ ポポ ドド ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ※ 玉 ポポ 








void 
InitSWTransfer( void ) 
| 


unsigned int uldx: 

/用 简单 的 递增 模式 填充 源 存 储 咒 缓冲 区 

for( uldx =0; uldx < MEM_BUFFER_SIZE; uldx ++ ) 
| 























g_ui32SrcBuf| uldx | = uldx; 
| 
// 使 能 软件 通道 的 uDMA 中 断 
ROM_IntEnable( INT_UDMA ) ; 
// 禁 止 pDMA 软件 通道 的 属性 设置 
ROM_uDMAChannelAttributeDisable( UDMA_CHANNEL_SW , 
UDMA_ATTR_USEBURST | UDMA_ATTR_ALTSELECT | 
(UDMA_ATTR_HIGH_PRIORITY | 
UDMA_ATTR_REOMASK ) ) ; 



























































// 配 SW 通道 的 控制 参数 
ROM_uDMAChannelControlSet( UDMA_CHANNEL_SW | UDMA_PRI_SELECT, 
UDMA_SIZE_32 | UDMA_SRC_INC_32 | UDMA_DST_INC_32 | 
UDMA_ARB 8 ) ; 
// 设 置 SW 通道 的 传输 参数 ,SW 必须 采用 自动 模式 
ROM_uDMAChannelTransferSet( UDMA_CHANNEL_SW | UDMA_PRI_SELECT, 
UDMA_MODE_AUTO, g_ui32SrcBuf, g_ui32DstBuf , 
MEM_BUFFER_SIZE ) ; 



































// 使 能 SW 的 pDMA 通道 

ROM_uDMAChannelEnable( UDMA_CHANNEL_SW ) : 

ROM_uDMAChannelRequest( UDMA_CHANNEL_SW ) ; 
| 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
// 配 置 UART 及 其 引 脚 


// ネネ ホネ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ 























void 
ConfigureUART( void ) 
| 
…( 省 略 ) 
1 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ チキ キキ キキ: 
// 主 程序 ,实现 DMA 传输 的 乒乓 模式 


// * ま ポポ ※ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポ ポポ ポポ ボネ ドド 玉 ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 





int 

main( void ) 

| 
static uint32_t ui32PrevSeconds; 
static uint32_t ui32PrevXferCount; 
static uint32_t m32PrevUARTCount =0: 
uint32_t ui32XfersCompleted ; 
uint32_t ui32BytesTransferred ; 


ROM_FPULazyStackingEnable( ) ; 
/设置 系统 时 钟 微 50 MHz 
ROM_SysCtlClockSet( SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN | 
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SYSCTL_XTAL_16MHZ) ; 
// 在 CPU 处 于 睡眠 时 使 能 外 设 操作 
ROM_SysCtlPeripheralClockGating( true) ; 
// 使 能 连接 板 载 LED 的 GPIOF 端口 
ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_CPIOF ) ; 
// 使 能 连接 LED( PF2) 的 CPIO 引 肢 
ROM_GPIOPinTypeGPIOOutput( GPIO_PORTF_BASE, GPIO_PIN_2) ; 
/初始 化 UART 
ConfigureUART( ) ; 
UARTprintf(" \033[ 2JuDMA Example\n" ) ; 
// 显 示 时 钟 频率 
UARTprintf( "Tiva C Series @ %u MHz\n\n" ,ROM._SysCtlClockGet( )/1000000 ) ; 
// 统 计 显 示 标题 
UARTprintf( "CPU Memory UART Remaining\n" ) ; 
UARTprintf(" Usage Transfers Transfers Time\n" ) ; 
// 配 置 SysTick 使 之 每 秒 发 生 100 次 作为 时 间 参 考 。 使 能 SysTick 产生 中 断 
ROM_SysTickPeriodSet( ROM_SysCtlClockGet( )/SYSTICKS_PER_SECOND ) : 
ROM_SysTickIntEnable( ) ; 
ROM_SysTickPnable( ) ; 
// 初 始 化 CPU 使 用 率 测量 程序 
CPUUsagelnit( ROM_SysCtClockGet( ) ,SYSTICKS_PER_SECOND,2) ; 
// 在 系统 级 使 能 uDMA 控制 器 。 使 能 处 理 器 处 于 睡眠 时 继续 运行 
ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_UDMA ) ; 
ROM_SysCtlPeripheralSleepEnable( SYSCTL_PERIPH_UDMA) ; 
// 使 能 LDMA 错误 中 断 
ROM_IntEnable( INT_UDMAERR ) ; 
// 使 能 LDMA 控制 器 
ROM_uDMAEnable( ) ; 
// 指 向 通道 控制 结构 的 控制 表 
ROM_uDMAControlBaseSet(ui8ControlTable ) ; 
/人 /初始 化 存储 器 到 存储 器 的 ADMA 传输 
InitSWTransfer( ) ; 
// 初 始 化 UART 的 pDMA 传输 
InitUART1Transfer( ) ; 
// 记 录 当 前 SysTick 的 秒 计 数值 
ui32 PrevSeconds =g_ui32Seconds: 
// 记 录 当 前 存储 器 组 种 区 的 计数 值 
Remember the current count of memory buffer transfers. 
um32PrevXferCount = g_m32MemXferCount: 
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/循环 等 待 直到 按钮 按 下 。 处 理 器 在 这 个 循环 中 处 于 休眠 状态 ,以 便 CPU 的 使 用 率 可 以 被 测 

















while(1) 

| 
// 检 查 是 否 耗 时 1 s。 如 果 是 , 则 更 新 
//updates. 
if(g ui32Seconds ! = ui32PrevSeconds ) 
| 





// 点 亮 绿 色 LED 
GPIOPinWrite(GPIO_PORTF_BASE,GPIO_PIN_2 ,GPIO_PIN_2) ; 
// 在 PuTTY 上 显示 CPU 使 用 的 百分比 ,其 小 数 部 分 被 忽略 























三 


| 


是 


中 | 





UARTprintf(" \r%3d% 2% ",g ui32CPUUsage > 16 ) ; 

// 记 录 新 的 秒 计数 值 

ui32PrevSeconds = g_ui32Seconds; 

// 计 算 从 上 一 秒 到 当前 传输 了 多 少 内 存 

ui32XfersCompleted = g_ui32MemXferCount - ui32PrevXferCount; 
// 记 录 新 的 传输 计数 值 

ui32PrevXferCount = g_ui32MemXferCount; 

// 计 算 从 上 一 秒 到 当前 有 多 少 个 字 节 的 数据 被 传输 
ui32BytesTransferred = ui32XfersCompleted * MEM_BUFFER_SIZE * 4; 
// 显 示 内 存 传 输 率 

if( ui32BytesTransferred >= 100000000) 

| 








UARTprintf("%3d MB/s " ,ui32BytesTransferred/1000000 ) ; 


| 
else if(ui32BytesTransferred >= 10000000 ) 


| 
UARTprintf(" %2d. %01d MB/s " ,ui32BytesTransferred/ 1000000,， 
(ui32BytesTransferred % 1000000)/100000); 
| 
else if( ui32BytesTransferred >= 1000000 ) 
| 
UARTprintf("% 1d. %02d MB/s " ,ui32BytesTransferred/1000000 , 
(ui32BytesTransferred % 1000000 )/10000) ; 


1 
i 


else if( ui32BytesTransferred >= 100000) 


| 
UARTprintf("%3d KB/s " ,ui32BytesTransferred/1000); 


1 
i 


else if( ui32BytesTransferred >= 10000) 
| 
UARTprintf(" %2d. %01d KB/s " ,ui32BytesTransferred/1000,， 
(un32BytesTransferred % 1000)/100) ; 


1 
1 


else if(ui32BytesTransferred >= 1000 ) 
| 
UARTPprintf( " %1d. %02d KB/s " ,ui32BytesTransferred/1000, 
(ui32BytesTransferred % 1000)/10); 


1 
i 


else if( ui32BytesTransferred >= 100 ) 
| 
UARTprintf(" %3d B/s " ,ui32BytesTransferred ) : 


1 
1 
else if( ni32BytesTransferred >= 10 ) 
| 


UARTprintf(" %2d B/s " ,ui32BytesTransferred ) : 


UARTprintf(" %1d B/s " ,ui32BytesTransferred ) : 
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| 

[计算 从 上 一 秒 发 生 了 多 少 次 UART 传输 

ui32XfersCompleted = (g_ui32RxBufACount + g_ui32RxBufBCount — 
ui32PrevUARTCount ) ; 

// 记 录 新 的 UART 传输 计数 值 

ui32PrevUARTCount = g_un32RxBufACount + g_ui32RxBufBCount; 

/计算 有 多 少 个 字 节 通过 UART 传输 

ui32BytesTransferred = ui32XfersCompleted * UART_RXBUF SIZE * 2; 

// 显 示 UART 传输 速率 

if( ui32BytesTransferred >= 1000000 ) 

| 























UARTprintf("% 1d. %02d MB/s " ,ui32BytesTransferred/1000000 , 
(ui32BytesTransferred % 1000000 )/10000) ; 


| 
else if(ui32BytesTransferred >= 100000 ) 


| 
UARTprintf("%3d KB/s " ,ui32BytesTransferred/1000); 


1 
i 


else if( ui32BytesTransferred >= 10000) 
| 
UARTprintf(" %2d. %01d KB/s " ,ui32BytesTransferred/1000,， 
(un32BytesTransferred % 1000)/100) ; 


1 
i 


else if( ui32BytesTransferred >= 1000) 


| 
UARTprintf("% 1d. %02d KB/s " ,ui32BytesTransferred/1000,， 
(ui32BytesTransferred % 1000)/10); 


1 
i 


else if( ui32BytesTransferred >= 100 ) 


| 
UARTprintf("% 3d B/s " ,ui32BytesTransferred ) ; 


1 
i 


else if( ui32BytesTransferred >= 10) 
| 


UARTprintf( " %2d B/s " ,ui32BytesTransferred ) ; 
| 
else 
| 
UARTprintf(" %1d B/s " ,ui32BytesTransferred ) : 
1 
1 
// 打 印 纺 丝线 
UARTprintf(" %2ds" ,10 -ui32PrevSeconds ) ; 
// 炸 灭 绿色 LED 


GPIOPinWrite( CPIO_PORTF_BASE,GPIO_PIN_2.0) ; 


1 
i 


// 使 处 理 器 进入 休眠 状态 
ROM_SysCtlSleep( ) ; 

// 如 果 运 行 时 间 大 于 等 于 10, 则 退出 循环 
if( g_ui32Seconds >= 10) 
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break: 


| 
// 在 PuTTY 上 显示 停止 信息 
UARTprintf(" \n 停止 \n" ) ; 




















/无 限 循环 且 CPU 不 进入 休眠 状态 ,以 便 可 进行 调试 


while(1) 
| 
// 点 亮 绿 色 LED 


CPIOPin Write( CPIO_PORTF_BASE,GPIO_PIN_2,GPIO_PIN_2) ; 





// 延 时 1 位 
SysCtlDelay( SysCtlClockGet( )/20/3); 
// 熄 灭 绿色 LED 


GPIOPinWrite( GPIO_PORTF_BASE,GPIO_PIN_2,0) ; 


// 延 时 1 位 
SysCtlDelay( SysCtlClockGet( )/20/3); 


| 


2) 在 C:\ti\TivaWare_C_Series -2.0.1.11577\examples\boards\EK -TM4C123GXL\ 目 录 


下 导入 udma_demo 工程 ， 如 图 13-5 所 示 。 





| CNtiVTivaWare_C_Series-2.0.1.1157 妨 examples\boards\ek-t 位 















日 -各 Source 
| 国 cpu_usage.c 

- 国 startup_rvmdk.S 
uartstdio.c 

トー 国 udma_demo.c 


ここ 国 ustdlib.c 
日 & Libraries 


国 driverlib.lib 
























File Edit View Project Flash Debug Peripherals Tools SVCS 
に | 氷 | 晶 中 
四 readme.txt 


EE EE 
int 
main (void) 














{ 
static ょ 
static 
static 
uint3 


= 


ーー 


13-5 导入 的 udma_demo 工程 


3) 编译 udma_demo 工程 并 下 载 到 EK -TM4C123GXL 开发 板 中 ， 如 图 13-6 所 示 。 


Build Output 


Connecting: Mode=JIAG, Speed=1000000Hz 
failed!, error code=td 





i\\TivaWare C Series-2.0.1.11577\\e 






Load "C:\\ti\\TivaWare C Series-2.0.1.11577\\exa, +\udma demo.axf"™ 


{> 
ず 、 


ぞ 
2 
者 











Ea 











13-6 将 .axf 可 执行 文件 下 载 到 EK - TM4C123GXL 板 中 
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4) 程序 功能 测试 。 
① 打开 PuTTY， 然 后 按 EK - TM4C123GXL 板 上 的 复位 键 ， 观 察 到 的 结果 如 图 13-7 
所 示 。 























并 COM7 - PuTTY | 























图 13-7 在 PuTTY 上 观察 到 的 程序 运行 结果 


② 当 保 留 时 间 从 9s 递减 到 1 s 过 程 中 ， 可 以 观察 到 板 上 的 绿色 LED 灯 不 断 闪烁 。 
③ 从 上 述 在 板 中 对 程序 的 测试 结果 来 看 ， 本 小 节 所 介绍 的 DMA 程序 实现 了 所 需 的 要 
求 ， 这 就 验证 了 程序 的 正确 性 。 
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ae 第 1 @ 0 


通用 串 行 总 线 控制 甸 (USB) 


本 章 简 要 介绍 通用 USB 控制 器 的 协议 与 基本 架构 ， 包 括 TM4C123GH6PM USB 控 制 装 的 
特点 ， 较 详细 地 介绍 DriverLib 库 中 USB 固件 函数 的 功能 与 USBlib 固件 库 的 结构 与 特点 ， 并 
以 TI 的 一 个 USB bulk 设备 例 程 来 介绍 USB 的 编程 与 测试 方法 。 


本 章 的 主要 内 容 : 


> USB 简介 
> TM4C123GH6PM USB 控制 器 
> USB 控制 器 国 件 库 函 数 (请 见 书 后 附录 工 ) 








> 例 程 

g 14.1 USB 简介 

9 伸和 
1. USB 概述 


USB ， 为 Universal Serial BUS (通用 串 行 总 线 ) 的 缩写 ， 是 一 个 外 部 总 线 标 准 ， 用 于 规 
范 PC 与 外 部 设备 的 连接 和 通信 。USB 接口 只 需要 四 根 连 线 ， 即 2 根 数据 线 、1 根 电源 线 、1 
根 地 线 ， 数 据 以 串 行 方式 传输 。 已 有 3 个 版 本 的 USB 协议 : USB1.1 (速率 12 Mbit/s)、 
USB2. 0 (速率 480 Mbit/s) 和 USB3. 0 (速率 4. 8 Gbit/s) ， 但 它 能 达到 的 最 大 传输 速率 却 取 
决 于 总 线 上 最 慢 的 “设备 ”， 这 包括 主机 、HUB9 (集线器 ) 和 USB 功能 设备 。USB 具有 支 
持 热 拔 插 、 应 用 广泛 且 使 用 方便 、 连 线 灵 活 以 及 独立 供电 等 优点 。USB 采用 差分 信号 来 传 
输 数据 ，USB 由 主机 、 设 备 和 互 连 三 部 分 组 成 。 其 中 “主机 ”是 指 提供 USB 接口 及 接口 管 
理 的 硬件 、 软 件 与 固件 的 集合 ， 它 可 以 是 PC 或 特殊 的 USB 设备 。 在 USB 系统 中 仪 允许 一 
个 USB 主机 存在 ; 而 “设备 ”包括 Hub 和 功能 ， 其 最 多 可 支持 127 个 设备 ; “ 互 连 ” 是 指 
USB 设备 与 主 计算 机 的 连接 和 通信 的 方式 ， 包括 总 线 拓扑 结构 、 内 层 关系 、 数 据 流 模 型 和 
USB 调度 表 等 。USB2. 0 使 用 轮 询 的 广播 方式 来 进行 数据 传输 ， 任 何 数 据 包 的 发 送 都 必须 由 
主机 来 启动 ， 在 USB 控制 器 中 的 任何 时 刻 只 允许 一 个 数据 包 在 执行 传输 任务 。 

注释 本 小 节 内 容 包含 来 自 网 络 、 参 考 文献 、USB 手册 中 有 关 USB 的 基础 知识 。 

2. USB 常用 术语 

(1) 管道 (Pipe) 

管道 是 主机 与 设备 端点 数据 传输 的 连接 通道 ， 表 征 主机 的 数据 缓冲 区 与 设备 端点 之 间 交 
换 数据 的 能 力 。 管 道 包 括 数据 流 管道 和 消息 管道 ，USB 设备 上 电 就 存在 一 个 信息 管道 , 使 
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USB 主机 可 通过 此 管道 来 获取 设备 的 描述 、 配 置 、 状 态 ， 并 对 设备 进行 配置 。 

(2) 端点 (Endpoint ) 

端点 是 USB 设备 中 可 进行 数据 收发 的 最 小 单元 ， 支 持 单 向 或 者 双向 的 数据 传输 。USB 
控制 器 可 提供 两 个 专用 的 控制 端点 〈 即 输入 :“IN” 和 输出 :“0OUT”) 以 及 可 用 于 与 主机 进 
行 通信 的 30 个 可 配置 的 端点 ( 即 15 个 IN 端点 和 15 个 OUT 端点 ) 。 

(3) 包 格 式 (Packeb) 

它 是 USB 总 线 上 数据 传输 的 基本 形式 ,在 USB 总 线 上 传输 的 数据 都 是 先 打包 后 进行 传 
输 的 。 它 包括 SOP ( 包 起 始 ) 、SYNC ( 包 同 歩 ) 、 包 内 容 和 EOP ( 包 结 束 ) 4 个 部 分 。 其 中 
“ 包 内 容 ” 由 PID 字段 、 地 址 字段 、 帧 号 字段 、 数 据 字段 和 CRC 字段 等 中 的 一 个 或 多 个 字段 
组 成 ， 如 图 14-1 所 示 。 


| sew | 包 同步 | 包 内 容 包 结束 
[ro | ws | 孤 


图 14-1 包 格 式 




















(4) 包 的 分 类 

① 令 牌 包 : 它 决定 数据 包 的 传输 类 型 ， 其 包含 PID 字段 、 地 址 字段 和 CRC 字段 。 在 
USB 控制 器 中 ， 仅 主机 可 发 出 令 牌 包 ， 它 是 事务 处 理 的 第 一 阶段 。 较 为 重要 的 令 牌 包 是 IN/ 
OUT/SETU。 

② 帆 首 包 : 它 包 含 PID 字段 、 帧 号 字段 和 CRC 字段 。 对 于 低速 /全 速 通信 每 隔 1 ms 发 
送 一 个 SOF ， 而 对 于 高 速 通信 每 隔 125 hs 发 出 一 个 帧 首 包 。 

③ 数据 包 : 它 包 含 PID 字段 、 数 据 字段 和 CRC 字段 ， 并 以 8 字 节 数据 字段 传输 。PID 
指定 是 DATAO 还 是 DATA1 用 于 数据 的 重 发 管理 ; 数据 字段 为 0 -1023 个 字 节 ; CRC 字段 为 
16 字 节 ， 用 于 对 数据 字段 进行 校 验 。 

④ 握手 包 : 握手 包 确 认 传输 是 否 成 功 ， 其 仅 包 含 PID 字段 ， 是 最 简单 的 信息 包 。 

(5) 事务 (Transaction ) 

事务 是 指 把 一 个 “服务 ”传送 到 一 个 “端点 ”的 处 理 过 程 ， 其 中 “服务 ”是 指 主机 发 
送 到 设备 的 数据 ， 或 主机 从 设备 接收 的 数据 。 事 务 包括 ; 

① IN (输入 ) 事务 : 即 总 线 上 的 USB 设备 向 USB 主机 发 送 数据 包 的 处 理 过 程 。 

② OUT (输出 ) 事务 : 即 USB 主机 向 总 线 上 的 USB 设备 发 送 数据 包 的 处 理 过 程 。 

③ SETUP 事务 : 仅 在 USB 控制 传输 中 用 于 对 USB 设备 进行 配置 。 

(6) 单 向 传输 

单 向 传输 是 指 在 某 个 端点 上 只 支持 一 个 方向 的 传输 ， 即 要 么 是 输出 ， 要 么 是 输入 。 若 要 
在 两 个 方向 上 进行 单 向 传输 ， 则 需要 占用 两 个 端点 并 分 别 进行 配置 。 

(7) 集 线 需 

它 提 供 把 标准 的 多 个 USB 设备 连接 到 主机 控制 器 的 功能 。 

(8) 设备 

设备 是 指 USB 设备 ， 由 一 个 或 多 个 配置 组 成 。 可 用 设备 描述 符 来 表达 设备 的 总 体 信息 。 
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(9) 配置 

一 个 USB 设备 可 用 一 个 或 多 个 配置 来 说 明 。 在 使 用 USB 设备 之 前 ， 需 为 该 设备 指定 一 
个 或 多 个 合适 的 配置 。 且 可 通过 配置 描述 符 来 说 明 。 

(10) 接口 

接口 为 断 点 的 集合 ， 可 包含 在 一 个 或 多 个 配置 中 。 可 通过 接口 描述 符 来 说 明 设备 中 的 接 
口 特性 。 

(11) USB OTC 

USB OTC 即 USB On - The - Go 的 缩写 ， 它 用 于 在 没有 主机 的 情况 下 ， 实 现 设备 间 的 数 
据 传输 。 

3. USB 拓扑 结构 

USB 的 拓扑 结构 如 图 14-2 所 示 。 

从 图 14-2 可 看 到 ,分 层 星 形 拓 扑 结 
构 ， 可 使 网 络 中 的 每 个 集线器 都 处 于 星 型 的 
中 心 ， 每 条 线段 都 是 点 对 点 的 连接 ， 以 实现 
USB 的 物理 连接 ， 电 绕 的 最 大 长 度 为 5 m。 
当 以 主机 - 根 集 线 器 (HOST - ROOT HUB) 
作为 起 点 时 ，USB 最 多 可 支持 7 个 分 层 
(图 14-2 中 仅 画 出 了 6 个 层 ) ， 即 USB 系统 
中 最 多 可 包含 5 个 HUB 的 级 联 。 一 个 复合 
设备 (Compound Device) 将 同时 占有 两 个 
或 更 多 的 层 。 

4. USB 总 线 信 号 

为 了 抗 干 扰 和 使 信号 同步 ， 在 USB 总 
线 上 传输 的 信和 号， 一般 采用 如 图 14-3 所 示 
的 NRZI ( 反 向 不 归 零 码 ) 编码 差分 信号 ， 图 14-2 USB 的 分 层 星 形 拓扑 结构 
并 且 需 在 NRZI 编码 前 ， 在 数据 中 的 恰当 位 置 添 0 来 保持 信号 的 同步 。 


0: EN 0 Oi Or O00 1 
J 
反 向 不 归 0 码 pzkgaelL mL mm 


較 14-3 NRZI 编码 差分 信和 号 
USB 电缆 信号 如 图 14-4 所 示 。 


VBus 
D+ 
D- 

GND 
































图 14-4 USB 电缆 信和 号 


其 中 ,，D+ 和 D -信号 即 为 NRZI 编码 差分 信号 、VBUS 为 +5V 电源 线 、GND 为 地 线 。 
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5. USB 通信 管道 

在 USB 控制 器 的 分 层 结构 中 ， 数 据 的 传输 是 通过 管道 进行 通信 的 ， 即 通过 主机 的 系统 / 
客户 软件 在 USB 设备 的 各 端点 之 间 进 行 的 ， 如 图 14-5 所 示 。 

6. USB 实现 

USB 的 实现 如 图 14-6 所 示 。 














主机 i 物理 设备 






















































USB 设 备 层 





USB 总 线 层 














< | 


7 
ーー 逻辑 通信 流 








图 14-5 USB 的 通信 管道 图 14-6 USB 的 实现 

















在 图 14-6 中 可 以 看 到 ,USB 控制 器 却 可 分 为 3 个 层次 ， 即 应 用 层 、USB 设备 层 和 USB 
总 线 层 。 每 层 都 由 不 同 的 功能 模块 构成 来 简化 通信 的 复杂 度 ， 其 中 USB 总 线 层 用 来 执行 主 
机 和 设备 之 间 数 据 传输 的 物理 层 实 现 和 总 线 管 理 ，USB 设备 层 对 于 USB 系统 软件 是 透明 的 ， 
依据 其 所 见 的 设备 层 来 执行 对 设备 的 操作 ; 应 用 层 可 以 利用 相应 的 客户 软件 向 主机 提供 一 些 
附加 的 功能 。 而 USB 设备 层 和 应 用 层 的 通信 只 是 逻辑 上 的 ， 真 实 的 物理 通信 由 USB 总 线 层 
来 执行 。 各 单元 的 功能 介绍 如 下 : 

(1) 客户 软件 

客户 软件 运行 于 USB 设备 的 主机 端 ， 来 自 于 操作 系统 或 USB 设备 提供 商 。 

(2) USB 系统 软件 

USB 系统 软件 为 USB 设备 提供 支持 的 特定 操作 系统 。 该 软件 通常 由 操作 系统 提供 ， 独 
立 于 特定 USB 设备 或 客户 端 软件 。 

(3) USB 主机 控制 器 

把 USB 设备 要 连接 到 一 个 主机 的 硬件 和 软件 。 

(4) 物理 设备 

在 USB 设备 端 执行 某 些 有 用 的 客户 程序 。 

7. 常用 的 USB 类 

1) 人 机 接口 类 (HID) 。 

① 不 需要 开发 PC 驱动 就 可 完成 USB 设备 的 开发 (驱动 由 Windows 操作 系统 支持 ) 。 

262 
























































② 可 提供 多 种 预定 义 的 通信 类 型 。 

③ 具有 高 度 的 灵活 性 。 

2) 通信 类 (CDC) 。 

3) 音频 类 (Audio) 。 

4) 设备 固件 升级 类 (DFU) 。 

① 允许 设备 通过 与 USB 主机 的 连接 来 完成 其 固件 的 升级 。 

② 允许 设备 在 其 设备 描述 符 中 通告 其 升级 能 

③ 在 组 合 设备 中 ，DFU 主要 作为 设备 的 子 类 ， 可 为 其 他 设备 类 增添 升级 功能 。 

④ 提供 一 种 更 加 通用 的 USB 启动 加 载 程序 。 

5) 大 容量 存储 设备 类 (MSC ) 。 

① 允许 微 控制 器 对 USB 大 容量 存储 媒 设备 (如 闪存 ) 进行 文件 的 读 / 写 。 

② 文件 系统 由 开源 程序 FatFs 提供 。 

注意 : 微软 已 经 为 这 5 类 提供 了 了 驱动 程序 ，TI 也 为 其 提供 了 演示 例 程 。 

8. 传输 中 的 包含 关系 

1) 传输 (Transfer) 2N 个 事务 (Transaction), N=1, 2, 3…。 

即 USB 总 线 上 的 一 个 “传输 ”由 一 个 或 多 个 “事务 ”组 成 。 

2) 事务 (Transaction) 2N 个 包 (Packet), N=1, 2, 3…。 

即 一 个 “事务 ”由 一 个 或 多 个 “ 包 ” 组 成 。 

9. 传输 类 型 

(1) 控制 传输 

用 于 可 靠 的 、 突 发 与 非 周 期 性 ， 由 主机 软件 发 出 的 请 求 或 回应 用 于 命令 和 状态 的 
传输 。 

(2) 中 断 传输 

用 于 小 规模 数据 、 周 期 性 与 低速 ， 人 允许 固 定 延 迟 的 通信 。 

(3) 同步 传输 

对 于 周期 与 持续 性 的 通信 ， 用 于 传输 与 时 效 相 关 的 信息 ， 并 且 在 数据 中 保存 时 间 和 玲 
信息 。 

(4) 批量 传输 

用 于 非 周期 性 、 批 量 可 靠 数据 的 通信 ， 数 据 可 占用 任意 带宽 ， 当 这 些 数据 没有 可 用 带宽 
时 ， 可 容忍 等 待 。 

10. 描述 符 (Descriptor ) 

描述 符 是 一 种 完整 的 数据 结构 ， 可 以 通过 C 语言 来 编程 实现 。 用 于 描述 USB 设备 的 功 
能 、 特 性 、 类 型 和 对 资源 的 需求 等 信息 。 其 目的 是 通 
每 个 设备 的 功能 。 只 有 主机 确认 了 这 些 信 息 之 后 ， 才 能 使 设备 正常 工作 。 常 用 的 描述 
如 下 : 

(1) 设备 描述 符 

它 是 设备 在 连接 到 主机 时 读 取 的 第 一 个 描述 符 ， 它 定义 了 USB 设备 类 、 制 造 商 ID 、 产 
品 ID 和 若干 个 配置 等 总 体 信息 ， 一 个 USB 设备 仅 包含 一 个 设备 描述 符 ， 并 且 该 描述 符 决 定 
了 设备 可 获得 的 “配置 ”个 数 ， 见 表 14-1。 
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表 14-1 设备 描述 符 
局 移 量 字 段 大 小 | 值 描 述 
0 bLength 1 数 字 描述 符 的 字 节 数 
1 bDecriptorType 1 常 量 设备 类 型 限定 符 (0x01 = 设备 描述 符 ) 
2 bcdUSB 2 | BCD | USB 规范 发 布 版 本 号 
4 bDeviceClass 1 类 类 代码 
3 bDeviceSubClass 1 子 类 子 类 代码 
6 bDevicePortocol 1 协议 协议 代码 
7 bMaxPacketSize0 1 数 字 端点 0 的 最大 包 大 小 ( 似 8 、16 、 32 、 64 为 合法 值 ) 
8 idVendor 2 | D 厂商 标志 (由 USB -IF 组 织 赋值 ) 
10 idProduct 2 ID 产品 标志 (由 厂商 赋 值 ) 
12 bcdDevice 2 BCD 设备 发 布 版 本 号 
14 iManufacturer 1 索引 厂商 信息 的 字符 串 描 述 符 的 索引 值 
15 iProduct 1 | 索引 | 产品 信息 的 字 串 描述 符 的 索引 值 
16 iSerialNumber 1 索引 设备 序列 号 信息 的 字 串 描述 符 的 索引 值 
17 bNumConfigurations 1 数 字 可 能 的 配置 数目 


(2) 配置 描述 符 


用 于 定义 设备 的 配置 信息 ， 如 接口 总 数 、 最 大 电源 消耗 等 。 
一 种 配置 ， 它 决定 了 设备 的 特性 和 人 能力。 并 且 通 过 描述 








一 个 USB 设备 至 少 可 包含 
符 可 获取 设备 “接口 ”的 个 数 ， 见 















































表 14-2。 
表 14-2 配置 描述 符 

局 移 量 字 段 大 小 | 值 描 述 
0 bLength 1 | 数字 | ”以 字 节 为 单位 的 描述 符 长 度 (0x09 ) 
1 bDescriptorType 1 常量 配置 描述 表 类 型 (0x02 ) 
ee 2 | 数字 返 区 的 配置 数据 的 总 长 。 包括 所 有 描述 符 的 组 合 长 度 ( 即 配 

置 、 接 口 、 端 点 和 设备 类 及 厂商 定义 ) 

4 bNumlnterfaces 1 数 字 配置 所 支持 的 接口 数目 
5 bCongfigurationV alue 1 数字 在 SetConfiguration( ) 请 求 中 用 作 参 数 来 选择 该 配置 的 值 
6 iConfiguration 1 索引 描述 该 配置 的 字 串 描述 表 索 引 
7 bmAttributes 1 位 图 自 供 电 / 远 程 唤醒 及 总 线 供 电 配置 
8 MaxPower 1 mA 以 2 mA 为 单位 的 总 线 功 耗 





(3) 接口 描述 符 


描述 一 个 接口 所 提供 

















的 配置 ， 如 接口 类 型 、 


使 用 了 何 种 非 0 端点 等 。 该 描述 符 包含 类 、 


子 类 与 协议 的 信息 ， 并 且 通 过 它 可 获取 设备 “端点 ”的 个 数 ， 见 表 14-3。 
表 14-3 接口 描述 符 



























































局 移 量 字 段 大 小 | 值 说 明 
0 bLength 1 | 数字 | ”以 字 节 为 单位 的 描述 符 长 度 (0x09) 
1 bDescriptorType 1 常量 接口 描述 符 类 型 (0x04 ) 
2 bInterfaceNumber 1 数 字 用 于 标识 接口 的 编号 
3 bAlternateSetting 1 数 字 用 来 选择 优先 字段 中 标识 接口 切换 设置 的 值 
4 bNumEndpoints 1 数字 接口 所 用 的 端点 个 数 (端点 0 除外 ) 

















( 续 ) 





























選 移 量 字 段 大 小 | 值 说 明 
5 blnterfaceClass 1 类 类 代码 
6 blnterfaceSubClass 1 子 类 子 类 代码 
7 blnterfaceProtocol 1 协议 协议 代码 
8 ilnterface 1 | 索引 接口 字 串 描述 符 的 索引 





(4) 端点 描述 符 
接口 的 每 个 端点 都 有 自己 的 描述 (端点 0 除外 ) ， 它 用 于 定义 每 个 端点 的 传输 类 型 与 速 
率 等 ， 见 表 14-4。 









































扁 移 量 字 段 大 小 | 值 说 明 
0 bLength 1 | 数字 | ”以 字 节 为 单位 的 描述 符 长 度 (0x07) 
1 bDescriptorType 1 | 常量 | 端点 描述 符 类 型 (0x05 ) 
2 bEndpointAddress 1 | 端点 | 描述 的 USB 设备 上 端点 的 地 址 与 方向 
3 bmAttributes 1 | 位 图 | ”选择 传输 类 型 与 附加 信息 
4 wMaxPacketSize 2 | 数字 | ”端点 所 能 接收 或 发 送 的 最 大 数据 包 的 大 小 
6 bInterval 1 | 数字 | ”数据 传输 时 端点 轮 询 的 间隔 或 NAK 率 


(5) 字符 描述 符 (可 选 ) 
用 于 提供 一 些 便于 阅读 的 信息 ， 见 表 14-5。 


表 14-5 字符 描述 符 























偏 移 量 字 段 大 小 | 值 描 述 
0 bLength 1 |N+2 以 字 节 为 单位 的 描述 符 长 度 (可変 ) 
1 bDescriptorType 1 常 量 字 串 描述 符 类 型 (0x03 ) 
2 wLANCID[0] 2 | 数字 | ”语言 标识 符 (LANGID) 代码 0 
N wLANGID[ x] 2 | 数 字 | ”语言 标识 符 (LANGID) 代码 x 














11. USB 设备 的 状态 转移 图 

USB 设备 的 状态 转移 图 如 图 14-7 所 示 。 

12. USB 设备 的 枚 举 

枚 举 是 USB 控制 器 中 的 重要 活动 ， 它 由 8 字 节 的 标准 请 求 组 成 。 通 过 枚 举 主机 可 以 获 
得 设备 的 各 种 描述 信息 ， 如 PID、VID、 设 备 分 类 、 配 置 数量 、 端 点 个 数 等 。 主 机 根据 这 些 
言 息 加 载 合 适 的 设备 驱动 程序 ， 并 对 设备 进行 合理 的 配置 ， 以 实现 USB 设备 的 特定 功能 
(可 对 比 图 14-7 的 USB 状态 转移 图 ) 。USB 设备 的 枚 举 过 程 归纳 如 下 : 

① 供电 一 @ 复位 一 @) 获取 设备 描述 符 前 八 个 字 节 数据 一 @@ 复位 (可 选 ) つ ⑤ 分 配 地 
址 一 @@) 获取 设备 描述 符 (重新 获取 设备 描述 符 来 得 到 设备 的 总 体 信 息 ) 一 @ 获取 配置 描述 
符 一 @) 获取 字符 串 描 述 符 (可 选 ) つ ⑨ 配置 。 
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总 线 超过 3ms 无 数据 传输 时 
挂 起 USB 设 备 以 减少 能 





HUB 复 位 / HUB 
取消 配置 。 配置 





























USB 主 机 为 设 
备 分 配 地 址 























TM4C123GH6PM USB 控制 器 支持 USB 主机 /设备 /OTG 功能 ， 在 点 对 点 通信 过 程 中 可 作 
为 全 速 和 低速 的 功能 控制 器 。 满 足 USB2. 0 标准， 包含 挂 起 和 恢复 信号 。16 个 端点 包含 2 个 
用 于 控制 传输 的 专用 连接 端点 〈 即 一 个 IN 和 一 个 OUT) 与 14 个 由 固件 定义 的 端点 ， 并 带 
有 一 个 大 小 可 动态 变化 的 FIFO 来 支持 多 包 队 列 。 采 用 pDMA 访问 FIFO 的 方法 ， 将 对 系统 
软件 的 依赖 度 降 至 最 小 。USB 设备 启动 方式 灵活 ， 可 软件 控制 是 否 在 启动 时 连接 ， 并 遵守 
OTC 标准 的 会 话 请 求 协议 (SRP) 和 主机 协商 协议 (HNP) 。 

该 驱动 程序 包含 在 DriverLib/usb. c 中 ，DriverLib/usb. h 包含 了 USB 控制 器 API 函数 的 
定义 。 











USB 的 特点 


TM4C123CH6PM USB 模块 有 如 下 特性 : 
1) 符合 USB - IF 认证 标准 。 
2) 支持 USB 2.0 全速 (12 Mbit/s) 和 低速 模式 (1.5 Mbit/s) 操作 。 
3) 集成 PHY。 
4) 连接 电源 管理 支持 使 用 链 路 状态 感知 ， 以 减少 能 耗 。 
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$) 4 种 传输 类 型 : 控制 传输 、 中 断 传输 、 批 量 传输 和 同步 传输 。 

6) 16 端点 。 

① 1 个 专用 的 IN 控制 端点 和 1 个 专用 OUT 控制 端点 。 

② 7 个 可 配置 的 IN 端点 和 7 个 可 配置 的 OUT 端点 。 

7) 4 KB 专用 端点 存储 空间 ，1 个 端点 可 定义 为 双 缓 存 1023 字 节 同步 传输 。 
8) 支持 VBUS 电压 下 降 (droop) 和 有 效 ID 检测 ， 以 及 发 出 中 断 。 

9) 采用 uDMA 提高 传输 数据 有 效 。 

① 用 于 发 送 和 接收 的 独立 通道 多 达 3 个 IN 端点 和 3 个 OUT 端点 。 

② 当 发 送 FIFO 中 包含 所 需 数量 的 数据 后 ， 可 产生 通道 请 求 。 


USB 模块 框图 


TM4C123GH6PM USB 的 模块 框图 如 图 14-8 所 示 。 









DMA 请 求 


CPU 接口 


解码 器 
AHB 总 线 - 
寄存 器 



























































USB 数 据 线 FIFO 解 码 器 


图 14-8 USB 模块 框图 





USB 信号 描述 
USB 信号 描述 见 表 14-6。 


表 14-6 USB 信号 (64LQFP) 






























































却 | 引 脚 人 郑 | 缓冲 区 
USBODM | 43 PD4 LO 模拟 USB0 的 双向 差分 数据 引 脚 (USB 中 的 D - 信号) 
USBODP | 44 PD5 0 模拟 USB0 的 双向 差分 数据 引 脚 (USB 中 的 D+ 信号 ) 
5 | PF4 (8) 
USBOEPEN| 14 | PC6 (8) | 0 TTL 在 主机 模式 中 ， 可 选 的 向 USB 总 线 供电 的 外 部 电源 控制 
63 | PD2 (8) 
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凶 





引 脚 | 引 脚 复 用 | 引 脚 | 缓冲 
却 名 称 述 
引 脚 名称 | | / 同 信 | 类 型 类 型 J 

















该 信号 用 于 检测 USB ID 信号 的 状态 。 此 时 USB PHY 将 在 使 能 一 个 
USBOID | 45 PBO I 模拟 集成 上 拉 电 阻 ， 通 过 外 部 元 件 (USB 连接 器 ) 检测 USB 控制 器 的 初始 
状态 ( 即 电缆 的 A 侧 配置 为 下 拉 电 阻 ，B 侧 配置 为 上 拉 电 阻 ) 

13 | PC7 (8) 在 主机 模式 中 ， 可 选 的 由 外 部 电源 管理 芯片 来 接收 电源 的 错误 状态 
USBOPFLT I TTL 

64 | PD3 (8) 指示 
此 信号 用 于 会 话 请 求 协议 。USB PHY 可 通过 此 信号 检测 VBUS 的 电 
平 ， 并 在 VBUS 脉冲 期 间 瞬 间 上 拉 

































































USBOVBUS| 46 PB1 1/0 模拟 


























USB 功能 描述 

TM4C123CH6PM USB 控制 器 支持 OTG 标准 的 会 话 请 求 协 议和 主机 协商 协议 ， 提 供 完整 
的 OTG 协商 会 话 请 求 协议 ， 人 允许 连接 在 USB 电缆 B 端的 B 类 设备 向 连接 在 A 端的 A 类 设 
备 发 出 请 求 ， 通 知 A 类 设备 打开 VBUS 电源 。 主 机 协商 协议 用 于 在 启动 会 话 请 求 协议 上 电 
后 ,决定 USB 电缆 哪 端 的 设备 作为 USB 主机 。 当 该 设备 连接 到 非 OTG 外 设 或 设备 时 ， 控 制 
器 可 以 检测 出 电缆 终端 所 使 用 的 设备 类 型 ， 并 提供 一 个 寄存 器 来 指示 该 控制 器 是 用 作 主 机 ， 
还 是 用 作 设 备 控制 器 。 以 上 的 操作 都 是 由 USB 控制 器 自动 处 理 的 。 基 于 这 种 自动 探测 机 制 ， 
系统 使 用 单个 的 A/B 型 连接 器 取代 A 型 或 B 型 连接 器 ， 可 支持 与 男 外 的 OTG 设备 完整 的 
OTG 协商 。 

另外 ，USB 控制 器 还 提供 对 连接 到 非 OTG 的 外 设 或 主机 控制 器 的 支持 。 可 将 USB 控制 
器 设置 为 专用 的 主机 或 设备 模式 ， 此 时 ，USBOVBUS 和 USBOID 引 脚 可 被 设置 成 CPIO 功能 
使 用 。 但 当 USB 控制 器 用 作 自 供电 设备 时 ， 必 须 将 CPIO 输入 引 脚 或 模拟 比较 器 输入 引 肢 
连接 到 VBUS 脚 上 ， 并 配置 为 在 VBUS 掉 电 时 将 发 出 中 断 。 该 中 断 用 于 禁止 USBODP 信号 的 
上 上 拉 电阻 。 

注意 : 当 使用 USB 模块 时 ， 时 钟 源 MOSC 无 论 使 用 PLL， 系 统 时 钟 应 至 少 为 20 MHz。 

1. 作为 设备 时 的 操作 

本 节 将 描述 TM4C123GH6PM USB 控制 器 用 作 USB 设备 时 的 行为 ， 包括 : IN 端点 、OUT 
端点 、 进 入 和 退出 挂 起 模式 、 帧 起 始 。 其 中 ，IN 事务 通过 使 用 端点 的 发 送 端 点 寄存 器 ， 由 
端点 的 发 送 接口 进行 控制 。0UT 事务 通过 使 用 端点 的 接收 端点 寄存 器 ， 由 端点 的 接收 接口 
进行 控制 。 

当 配 置 端点 的 FIFO 大 小 时 ， 需 要 考虑 最 大 数据 包 的 大 小 。 

① 批量 传输 : 批量 端点 的 FIFO 可 配置 为 最 大 包 长 (64 个 字 节 ) ， 如 果 使 用 双 包 缓存 ， 
则 需要 配置 为 2 倍 于 最 大 包 长 大 小 。 

② 中 断 传输 : 中 断 端点 的 FIFO 可 配置 为 最 大 包 长 ， 如 果 使 用 双 包 缓存 ， 则 需要 配置 为 
两 倍 的 最 大 包 长 大 小 。 

③ 同步 传输 : 同步 端点 的 FIFO 比较 灵活 ， 最 大 可 支持 1023 字 节 。 

④ 控制 传输 : 也 可 以 用 于 为 USB 设备 指定 一 个 独立 的 控制 端点 。 但 是 在 大 多 数 情况 
下 , USB 设备 应 该 在 USB 控制 器 的 端点 0 上 使 用 专用 的 控制 端点 。 
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(1) 端点 

USB 控制 器 提供 两 个 专用 的 控制 端点 ( 即 IN 和 OUT) 与 可 用 于 跟 主 机 控制 器 进行 通信 
的 14 个 可 配置 的 端点 〈 即 7 个 IN 和 7 个 OUT) 。 端 点 号 和 方向 与 对 应 的 相关 寄存 器 直接 关 
联 。 例 如 ， 在 主机 向 端点 1 发 送 数据 时 ， 所 有 的 配置 和 数据 都 存在 端点 1 的 外 送 寄 存 器 接 
口中 。 

端点 0 是 专用 的 控制 端点 ， 用 于 在 枚 举 期 间 所 有 对 端点 0 的 控制 传输 事务 ， 或 对 端点 0 
的 其 他 控制 请 求 。 端 点 0 使 用 USB 控制 器 FIFO RAM 中 的 首 64 字 节 ， 该 内 存 对 于 IN 传输 事 
务 和 OUT 传输 事务 是 共享 的 。 剩 余 的 14 个 端点 可 配置 为 控制 、 批 量 、 中 断 或 同步 端点 。 其 
中 7 个 配置 为 IN 端点 ， 另 外 7 个 配置 为 OUT 端点 。 这 些 成 对 的 端点 类 型 可 以 不 同 。 例 如 ， 
成 对 端点 的 OUT 部 分 可 配置 成 批量 端点 ，IN 部 分 可 配置 成 中 断 端点 。 连 接 到 每 个 端点 的 
FIFO 的 地 址 和 大 小 可 根据 实际 需求 来 修改 。 

(2) IN 事务 

IN 数据 传输 可 通过 发 送 端点 的 FIFO 来 处 理 。7 个 可 配置 IN 端点 的 FIFO 大 小 , 由 USB 
发 送 FIFO 的 起 始 地 址 寄存 器 (USBTXFIFOADD) 决定 。 传 输 时 发 送 端点 FIFO 中 的 最大 数 
据 包 长 可 编程 配置 ， 其 大 小 由 写 入 该 端点 的 USB 端点 n 的 发 送 最 大 发 送 数据 寄存 器 
(USBTXMAXPn) 中 的 値 決定 。 端 点 的 FIFO 既 可 配置 成 双 包 缓存 ， 也 可 配置 成 单 包 缓存 。 
当 双 包 缓 存 使 能 时 ， 在 FIFO 中 可 缓冲 两 个 数据 包 ， 要 求 FIFO 的 容量 应 不 小 于 两 个 数据 包 的 大 
小 。 当 禁止 双 包 缓存 时 ， 即 使 数据 包 长 小 于 FTFO 容量 的 一 半 ， 也 仅 能 缓冲 一 个 数据 包 。 

(3) OUT 事务 

OUT 事务 的 数据 可 通过 接收 端点 的 FIFO 来 处 理 。7 个 可 配置 OUT 端点 的 FIFO 大 小 ， 
由 USB 输出 FIFO 的 起 始 地 址 寄存 带 (USBRXFIFOADD) 决定 。 任 何 接 收 端 点 FIFO 中 的 最 
大 数据 包 长 都 可 编程 配置 ， 其 大 小 由 写 人 该 端点 的 USB 端点 n 的 最 大 接收 数据 寄存 器 
(USBRXMAXPn) 中 的 值 决 定 。 当 双 包 缓存 使 能 时 ， 在 FIFO 中 可 缓冲 两 个 数据 包 。 当 禁止 
双 包 缓存 时 ， 即 使 数据 包 长 小 于 FIFO 容量 的 一 半 ， 也 仅 能 缓冲 一 个 数据 包 。 

(4) 调度 

设备 无 权 控制 事务 调度 ， 而 只 能 由 主机 来 调度 决定 。TM4C123GH6PM USB 控制 器 可 随 
时 建立 传输 事务 。USB 等 待 从 主机 发 出 的 请 求 以 及 当 事 务 传输 完成 或 由 于 某 些 错 误 而 终止 
时 ， 都 会 产生 一 个 中 断 。 如 果 主 机 发 起 请 求 ， 而 设备 还 未 准备 就 绪 ， 那 么 USB 将 对 所 有 请 
求 发 送 一 个 忙 响应 (NAK) 信和 号， 直到 其 准备 就 绪 。 

(5) 挂 起 

当 USB 总 线 超过 3 ms 时 间 无 数据 传输 时 ， 它 将 自动 进入 挂 起 (SUSPEND) 模式 。 如 果 
在 USB 中 断 使 能 寄存 器 (USBIE) 中 已 使 能 挂 起 中 断 ， 这 时 将 会 产生 一 个 中 断 。 当 USB 控 
制 絮 处 于 挂 起 模式 下 ，USB PHY 也 可 进入 挂 起 模式 。 当 检测 到 恢复 信号 时 ，USB 将 退出 挂 
起 模式 ， 并 且 USB PHY 也 将 退出 挂 起 模式 。 如 果 已 使 能 了 恢复 中 断 ， 则 将 产生 一 个 中 断 。 
可 通过 配置 USB 电源 寄存 器 (USBPOWER) 中 的 RESUME 位 来 强制 USB 控制 器 退出 挂 起 
模式 。 当 该 位 被 置 位 ， 使 USB 控制 器 退出 挂 起 模式 ， 同 时 恢复 信号 将 出 现在 总 线 上 。 
RESUME 位 必须 在 10 ms (最大 15 ms) 后 被 清 零 以 结束 恢复 信号。 

注意 : 为 了 满足 USB 电源 要 求 ， 控 制 器 可 以 进入 深度 休眠 模式 ， 使 控制 器 保持 在 静止 状 
态 。 体 眠 模式 不 应 该 用 于 挂 起 模式 ， 因 为 所 有 的 内 部 状态 信息 在 处 于 休眠 状态 时 将 会 丢失 。 
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(6) 帧 起 始 

在 设备 模式 时 ， 其 每 1 ms 将 接收 到 由 主机 发 出 的 帧 起 始 包 (SOF) 1 次 。 在 收 到 SOF 数 
据 包 时 ， 数 据 包 中 的 11 位 帧 号 将 被 写 入 到 USB 帧 值 寄存 器 (USBFRAME) 中 ， 且 发 出 SOF 
中 断 信号 〈 由 应 用 程序 来 处 理 ) 。 一 旦 USB 控制 器 开始 接收 SOF 包 ， 预 计 每 1 ms 接収 1 次 。 
如果 1. 00358 ms 后 仍 未 收 到 SOF 包 ， 可 认为 该 包 已 丢失 ， 并 且 USBFRAME 寄存 器 也 不 会 被 
更 新 。 在 重新 成 功 接收 这 些 数据 包 时 ，USB 控制 器 将 继续 并 重新 同步 这 些 脉冲 来 接收 
SOF 包 。 

(7) USB 复位 

在 检测 到 USB 总 线 上 的 复位 条 件 时 ，USB 控制 器 将 会 自动 执行 以 下 操作 : 

① 清除 USBFADDR 寄存 器 

② 清除 USB 端点 索引 寄存 器 (USBEPIDX) 。 

③ 刷新 所 有 端点 FIFO。 

④ 清除 所 有 的 控制 /状态 寄存 央 

⑤ 使 能 所 有 端 点 中 断 。 

⑥ 产生 一 个 复位 中 断 。 

在 应 用 软件 驱动 的 USB 控制 器 中 收 到 复位 中 断 时 ， 将 关闭 任何 打开 的 管道 ， 并 等 待 
USB 控制 器 开始 总 线 枚 举 。 

(8) 连接 / 断 开 

连接 到 USB 总 线 上 的 USB 控制 器 将 由 软件 来 处 理 。USB PHY 通过 置 位 和 清 零 USB- 
POWER 寄存 器 中 的 SOFTCONN 位 ， 使 其 可 在 正常 模式 和 无 驱动 模式 之 间 切 换 。 当 SOFT- 
CONN 位 置 位 时 ，USB PHY 为 正常 模式 ，USB 总 线 上 的 USBODP/USBODM 线 被 使 能 。 同 时 ， 
USB 控制 器 不 会 响应 任何 信号 (USB 复位 除外 ) 。 

在 SOFTCONN 位 清 零 时 ，USB PHY 为 无 驱动 模式 ，USBODP 和 USBODM 为 高 阻 态 ， 这 
时 ， 对 于 USB 总 线 上 的 其 他 设备 ，USB 控制 器 为 断 开 状态 。 因 无 驱动 模式 为 默认 状态 ， 所 
以 USB 控制 器 只 有 在 SOFTCONN 位 置 位 时 才 会 被 接 通 。 然 后 ， 应 用 软件 可 以 选择 何 时 设置 
PHY 进入 正常 模式 。 系 统 将 经 历 一 个 较 长 时 间 来 初始 化 程序 ， 以 确保 初始 化 完成 。 在 连接 
USB 总 线 之 前 ， 为 系统 的 设备 枚 举 做 好 准备 。 一 旦 SOFTCONN 位 置 位 ，USB 控制 器 可 通过 
清除 该 位 来 断 开 连接 。 

注意 : 当 设备 连接 到 主机 时 ，USB 控制 器 不 会 产生 中 断 。 不 过 当主 机 终止 会 话 时 ， 将 会 
产生 一 个 中 断 。 

2. 作为 主机 时 的 操作 

当 TM4C123CH6PM 控制 器 运行 在 主机 模式 时 ,在 USB 由 设备 变 为 主机 或 由 主机 变 为 设 
备 前 ， 必 须 通过 设置 软件 复位 控制 寄存 器 2 (SRCR2) 中 的 USBO 位 来 复位 USB 控制 器 。 
USB ee 支持 点 对 点 通信 和 通过 集线器 操作 。 人 允许 USB 2. 0 集线器 使 用 低 
速 设备 和 全 速 设备 。 支 持 控 制 传输 、 批 量 传 输 、 同 步 传 输 和 中 断 传输 。 本 小 节 描 述 当 USB 
在 主机 模式 时 的 操作 ， 但 与 设备 操作 类 似 的 部 分 ， 这 里 不 再 累 述 。 

(1) 端点 

专用 的 控制 接口 只 用 于 与 设备 的 端点 0 之 间 的 控制 传输 。 其 用 于 设备 枚 举 或 其 他 使 用 该 
端点 的 控制 功能 。 控 制 端点 的 IN 和 OUT 事务 共享 USB FIFO 内 存 中 的 首 64 字 节 。 其 余 IN 
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和 OUT 接口 可 配置 为 与 控制 端点 、 批 量 端点 、 中 断 端 点 或 同步 端点 通信 。 

这 些 USB 接口 可 同时 调度 ， 可 用 于 与 任何 设备 的 任何 端点 的 7 个 独立 的 OUT 事务 和 7 
个 独立 的 IN 事务 。 并 用 三 组 成 对 的 寄存 器 来 控制 IN 和 OUT 端点 。 通 过 配置 可 与 不 同类 型 
的 端点 以 及 不 同 设备 的 不 同 端点 进行 通信 。 例 如 ， 第 一 对 端点 可 分 开 控 制 ， 即 输出 部 分 与 设 
备 的 批量 输出 端点 1 通信 ， 输 入 部 分 与 设备 的 中 断 端 点 2 通信 。 

无 论 用 于 点 对 点 通信 还 是 通过 集线器 通信 ， 在 访问 设备 前 ， 都 必须 设置 相关 的 USB 端 
点 n 的 接收 功能 地 址 寄存 器 (USBRXFUNCADDRn ) 或 USB 端点 n 发 送 功能 地 址 寄存 器 
(USBTXFUNCADDRn) ， 以 记录 每 个 接收 和 发 送 端点 将 要 访问 的 设备 地 址 。 

USB 控制 器 支持 通过 USB 集线器 连接 设备 ， 这 可 通过 一 个 寄存 器 实现 ， 该 寄存 器 说 明 
集线器 地 址 和 每 个 传输 的 端口 。FIFO 的 地 址 和 大 小 可 定制 ， 并 可 指定 用 于 任 一 USB 输入 和 
输出 的 传输 。 

(2) IN 事务 

IN 事务 的 处 理 采 用 与 设备 模式 处 理 0UT 事务 类 似 的 方式 ， 但 传输 事务 必须 通过 设置 寄 
存 器 USBCSRLO 中 的 REQPKT 位 开始 ， 向 事务 调度 指示 该 端点 存在 一 个 激活 的 传输 。 此 时 
事务 调度 向 目标 设备 发 送 1 个 输入 令 牌 包 。 当 接收 到 数据 包 且 存放 到 接收 FIFO 中 时 ， 
USBCSRLO 寄存 器 中 的 RXRDY 位 置 位 ， 同 时 产生 相应 的 接收 端点 中 断 信 号 ， 指 示 有 1 全数 
据 包 需要 从 FIFO 中 读 出 。 

在 数据 包 读 出 时 ， 必 须 将 RXRDY 位 清 零 。USBRXCSRHn 寄存 器 中 的 AUTOCL 位 可 用 
于 在 最 大 包 从 FIFO 中 读 出 时 将 自动 清 零 RXRDY 位 。 在 RXRDY 位 清 零 时 ，USBRXCSRHn 
寄存 器 中 的 AUTORO 位 将 会 使 REQPKT 位 自动 置 位 。AUTOC 和 AUTORO 位 可 与 pDMA 配 
合 使 用 ， 可 实现 无 需 处 理 器 干预 的 批量 传输 。 在 RXRDY 位 清 零 时 ， 控 制 器 会 向 设备 发 出 1 

条 确认 信息 。 在 确定 传输 的 数据 包 个 数 时 ， 将 在 与 该 端点 关联 的 USB 端点 n 块 传输 请 求 包 
数量 寄存 器 (USBRQPKTCOUNTn) 中 配置 要 传输 的 数据 包 个 数 。 每 次 请 求 前 ，USB 控制 器 
都 将 USBROPKTCOUNTn 寄存 器 中 的 值 减 1。 当 USBROPKTCOUNTn 寄存 器 中 的 值 减 到 0 
时 ， 将 清 零 AUTORQ 位 以 阻止 后 面试 图 进行 的 事务 。 如 果 传 输 的 数量 未 知 ， 则 应 当 将 
USBROPKTCOUNTn 位 清 零 。AUTORNQ 保持 置 位 状态 ， 直 到 接收 到 一 个 短 包 才 清 零 ， 此 种 情 

只 在 批量 传输 的 未 尾 才 可 出 现 。 

如 果 设 备用 NAK 响应 批量 或 中 断 传输 的 输入 令 牌 ，USB 主机 将 重 试 直到 达到 设置 的 
NAK 限制 次 数 。 如 果 目 标 设备 用 STALL 握手 响应 ，USB 主机 将 不 重 试 传输 ， 而 将 寄存 器 
USBCSRLO 中 的 STALLED 位 置 位 。 如 果 目 标 设备 在 需要 的 时 间 内 不 响应 输入 令 牌 包 ， 或 包 
存在 CRC 或 位 填充 错误 ，USB 主机 将 重 试 传输 。 如 果 三 次 重 试 ， 目 标 设备 仍 无 响应 ，USB 
控制 器 将 把 REQPKT 位 清 零 ， 将 USBCSRLO 寄存 器 中 的 ERROR 位 置 位 。 

(3) OUT 事务 

OUT 事务 的 处 理 采用 与 设备 处 理 IN 事务 类 似 的 方式 。 当 包装 载 到 发 送 FIFO 中 时 ， 
USBTXCSRLn 寄存 器 中 的 TXRDY 位 必须 置 位 。 耕 将 USBTXCSRHn 寄存 器 中 的 AUTOSET 位 
置 位 ， 当 最 大 包 长 的 包装 载 到 FIFO 中 时 ，TXRDY 位 将 自动 置 位 。 此 外 ，AUTOSET 位 与 
kDMA 控制 器 配合 使 用 ， 可 在 不 需要 软件 干预 的 情况 下 完成 批量 传输 。 

若 目 标 设 备用 NAK 响应 输出 令 牌 包 ，USB 主机 将 重 试 直到 达到 设置 的 NAK 限制 次 数 。 
如 果 目 标 设备 用 STALL 握手 响应 ，USB 主机 将 不 会 重 斌 传输， 而 通过 将 USBTXCSRLn 寄存 
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器 中 的 STALLED 位 置 位 来 中 断 主 处 理 器 。 若 目标 设备 在 要 求 的 时 间 内 不 响应 输出 令 牌 包 ， 
或 包 存在 CRC 或 位 填充 错误 ，USB 主机 将 重 试 传输 。 如 果 三 次 重 试 ， 目 标 设备 仍 无 响应 ， 
USB 将 清空 FIFO， 以 及 把 寄存 器 USBTXCSRLn 中 的 ERROR 位 置 位 。 

(4) 事务 调度 

事务 调度 由 USB 主机 自动 处 理 。USB 主机 允许 根据 端点 事务 类 型 配置 端点 通信 调度 。 
中 断 传 输 既 可 每 1 帧 进行 1 次， 也 可 每 255 帧 进行 1 次 ， 可 在 1 ~255 帧 之 间 以 1 帧 的 递增 
调度 。 批 量 端点 不 允许 调度 参数 ， 但 在 设备 端点 不 响应 时 ， 人 允许 NAK 超时 。 同 步 端 点 可 在 
1 ~ 216 帧 之 间 调 度 (2 的 震 ) 。 

USB 维持 帧 计数 。 如 果 目 标 设备 为 全 速 设备 ， 控 制 器 在 每 帧 开始 时 将 自动 发 送 SOF 包 ， 
同时 帧 计数 值 加 1。 若 目标 设备 为 低速 设备 ， 将 在 总 线 上 发 送 K 状态 来 保持 总 线 激活 ， 防 止 
低速 设备 进入 挂 起 模式 。 

在 发 送 SOF 包 后 ，USB 主机 控制 器 将 巡 检 所 有 配置 就 绪 的 端点 ， 寻 找 激 活 的 传输 事务 。 
对 于 REOPKT 位 置 位 的 接收 端点 或 TXRDY 或 FIFONE 位 置 位 的 发 送 端点 ， 可 视 为 存在 激活 
的 传输 事务 。 

若 传输 创建 在 1 帧 的 第 一 个 调度 周期 ， 而 且 端 点 的 间隔 计数 器 减 到 0， 那 么 同步 传输 和 
中 断 传 输 开 始 。 因 此 每 个 端点 的 中 断 传输 和 等 同步 传输 每 n 帧 才 会 发 生 1 次, 其 中 n 为 在 
USBTXINTERVALn 或 USBRXINTERVALn 寄存 器 设置 的 间隔 。 

阁 在 帧 中 的 下 一 个 SOF 包 前 有 足够 时 间 来 完成 传输 ， 则 激活 的 批量 传输 会 立即 开始 。 
如 果 传 输 需 要 重 发 时 ， 需 要 在 调度 器 先行 检查 完 其 他 端点 是 否 有 激活 的 传输 之 后 ， 才 能 重新 
传输 。 这 保证 了 发 送 大 量 NAK 响应 的 端点 不 会 阻塞 总 线 上 的 其 他 传输 的 正常 进行 ,并且 允 
许 用 户 设置 目标 设备 发 送 NAK 端点 的 超时 限制 。 

(5) USB 集线器 

以 下 介绍 仅 可 使 用 USB 2. 0 集线器 的 主机 。 当 低速 设备 或 全 速 设备 通过 USB 2. 0 集 线 
器 连接 到 USB 主机 时 ， 集 线 器 的 地 址 和 端口 的 详细 信息 必须 记录 在 相应 的 USB 端点 n 接收 
集线器 地 址 (USBRXHUBADDRn) 和 接收 集线器 端口 (USBRXHUBPORTn) 或 USB 发 送 集 
线 器 地 址 (USBTXHUBADDRn) 和 发 送 集 线 器 端口 (USBTXHUBPORTn ) 寄存 器 中 。 此 外 ， 
设备 的 运行 速度 也 必须 记录 在 USB 类 型 端点 0 寄存 器 (USBTYPE0) 、USB 端点 n 主机 配置 
发 送 类 型 寄存 器 (USBTXTYPEn) 或 主机 配置 接收 类 型 寄存 器 (USBRXTYPEn) 中 。 

对 于 集线器 通信 ， 为 了 支 持 更 多 数量 的 设备 ，USB 主机 允许 通过 简单 的 更 新 记录 在 这 
些 寄存 器 中 的 地 址 和 速度 信息 来 动态 改变 这 些 配置 。 设 备 功 能 端点 配置 的 改变 必须 在 相关 端 
点 正在 进行 的 传输 完成 后 进行 。 

(6) OTG 模式 

为 了 省 电 ，USB OTG 允许 当 需 要 时 才 给 VBUS 上 电 ， 在 不 使 用 USB 总 线 时 ， 断 开 
VBUS， 而 VBUS 总 是 由 总 线 上 的 A 设备 提供 。OTCG 控制 器 通过 PHY 采样 ID 输入 来 决定 哪 
个 是 A 设备 哪个 是 B 设备 。 在 ID 信号 拉 低 时 ， 表示 OTG 控制 器 作为 A 设备 使 用 ; 在 ID 信 
号 为 高 时 ， 表 示 OTC 控制 器 作为 B 设备 角色 。OTG 的 操作 过 程 如 下 : 

① 开始 会 话 。 

② 活动 性 探测 。 

③ 主机 协商 。 
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3. DMA 操作 

USB 外 设 提供 了 连接 到 pDMA 控制 器 的 接口 。uDMA 控制 器 提供 了 3 个 发 送 端点 和 3 
个 接收 端点 的 独立 通道 。 通 过 USB DMA 选择 寄存 器 (USBDMASEL ) ， 软 件 可 选择 哪个 端点 
要 使 用 wDMA 通道 服务 。 发 送 和 接收 通道 分 别 通过 USBTXCSRHn 和 USBRXCSRHn 寄存 央 
来 使 能 USB 的 pDMA 操作 。 当 gDMA 操作 使 能 时 ，USB 在 FIFO 可 传输 数据 时 ， 将 在 使 能 
的 接收 或 发 送 通道 上 发 出 pDMA 请 求 。 当 任 一 FIFO 可 传输 数据 时 ， 则 该 通道 发 出 突 发 请 
求 。kDMA 通道 必须 配置 为 基本 模式 ，ADMA 传输 的 大 小 需 限制 为 USB FIFO 的 整数 倍 。 使 
用 pkDMA 的 USB FIFO 的 读 / 写 传输 都 须 这 样 配置 。 

大 USBTXCSRHn/USBRXCSRHn 寄存 器 中 的 DMAMOD 位 清 零 ， 则 在 wDMA 传输 中 的 每 
个 包 传 输 完成 后 都 会 产生 中 断 信 号 ， 但 uuDMA 会 继续 传输 数据 。 如 果 DMAMOD 位置 位 , 整 
个 ADMA 传输 完成 后 才 会 产生 中 断 信号 。 此 中 断 将 加 载 到 USB 的 中 断 向 量 中 。 因 此 ， 如 果 
USB 操作 使 用 了 中 断 和 使 能 了 phyDMA， 则 必须 设计 USB 中 断 服务 函数 来 处 理 该 中 断 。 


































































































本 小 节 将 简要 介绍 USB 库 的 函数 功能 (DriverLib 库 部 分 ) 及 USBlib 分 层 框架 结构 。 
USB 固件 库 包 括 两 个 部 分 : DriverLib 库 和 USBlib 库 。 


USB 的 分 层 框架 结构 
国 件 库 分 层 结构 可 使 开发 人 员 依 照 自己 的 需求 来 调用 不 同 层 的 API， 如 图 14-9 所 示 。 











应 用 程序 1: 应 用 程序 2: 应 用 程序 3: 应 用 程序 4: 
调用 驱动 程序 库 来 | | 调用 已 有 的 API 来 完成 | | 将 重要 信息 传递 至 驱动 || 将 简化 数据 传递 到 较 高 
自己 的 USB 协 | | 通用 的 主机 /设备 操作 。| | 器 程序 API。 屋 API。 

















驱动 器 API 完 成 控制 选 (定制 HD 鼠 标 ) 
调用 驱动 程序 库 来 执 定 类 的 所 有 较 低 层 的 功 
(第 三 方 USB 堆 栈 ) | | 行 本 协议 没有 实现 的 能 。 
功能 。 


(定制 类 ) 


(定制 HID 设 备 ) 


USBlib.lib に 


USB 主 机 控制 器 API/USB 设 备 API 


Driverlib.lib USB 驱 动 程序 库 API 


定制 增加 


图 14-9 USB 库 的 框架 结 术 





局 





在 图 14-9 中 所 示 的 4 种 可 能 的 应 用 程序 ， 将 使 用 不 同 的 编程 接口 来 实现 自己 的 USB 
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功能 。 下 面 将 简要 介绍 图 中 4 层 API 函数 的 特点 : 

1) USB 驱动 程序 库 API (USB DriverLib API) : 是 USB 设备 堆栈 中 最 底层 的 USB 驱动 
程序 ， 位 于 DriverLib 库 中 的 usb. c 源 代 码 和 头 文 件 wsb.h. 中。 在 图 14-9 中 的 “应 用 程序 
1” 提 供 了 直接 编写 设备 功能 的 API。 其 实 ， 这 个 API (固件 库 ) 是 上 面 USB 控制 器 硬件 寄 
存 器 中 非常 薄 的 一 层 ， 因 此 不 提供 任何 更 高 级 别 的 USB 事务 支持 ( 如 端点 零 事 务 处 理 ， 标 
准 描 述 符 和 请 求 处 理 等 ) ， 应 用 程序 通常 不 会 仅 使 用 这 个 API 来 访问 USB 功能 。 所 以 ， 该 
驱动 程序 库 在 开发 USB 应 用 时 适合 作为 一 个 接口 来 使 用 ,例如 ， 第 三 方 的 USB 堆栈 。 

2) USB 设备 API (USB Device API) : USB 设备 API 在 USB 库 用 尽 可 能 多 的 类 独立 代码 
为 开发 全 功能 的 USB 设备 应 用 程序 提供 了 一 组 专门 的 函数 。 该 API 通过 从 主机 标准 请 求 支 
持 设备 枚 举 并 处 理 代 表 应 用 程序 的 端点 零 状态 机 。 使 用 该 接口 的 应 用 程序 将 提供 在 初始 化 期 
间 要 发 布 到 主机 的 描述 符 ， 以 及 提供 配置 硬件 所 需 的 USB 设备 API 信息 。 不 但 与 异步 事件 
有 关 的 USB 设备 通过 回调 函数 集 来 通知 应 用 程序 ， 而 且 还 提供 了 对 USB 设备 初始 化 的 API。 
该 API 用 于 在 USB 设备 类 驱动 程序 的 开发 以 及 提供 现 有 类 驱动 程序 不 支持 的 USB 功能 应 用 
程序 的 直接 使 用 ， 也 可 以 被 现 有 的 类 驱动 程序 API (USB Device Class Driver API) 不 支持 的 
USB 功能 应 用 直接 使 用 。 该 设备 的 例子 需要 复杂 的 接口 切换 设置 。USB 设备 API 可 看 作 是 
一 组 扩展 USB DriverLib 库 的 高 层次 API， 而 不 仅仅 是 对 其 进行 简单 的 封装 。 因 此 ， 在 开发 
USB 设备 API 时 ， 调 用 一 些 底层 USB 驱动 API 仍然 是 必要 的 。 

3) 设备 类 驱动 程序 API (USB Device Class Driver API) : 设备 类 驱动 程序 库 提 供 了 所 需 
高 层次 特定 的 USB 功能 ， 而 无 需 大 多 数 的 USB 事务 处 理 和 所 需 的 连接 管理 。 这 些 驱动 程序 
提供 高 层次 的 API， 几 种 常用 USB 设备 类 的 特点 如 下 : 

① 使 用 极为 方便 。 即 设备 设置 包括 创建 一 组 静态 的 数据 结构 和 调用 单一 的 初始 化 API。 

② 可 配置 的 VID/PID、 电 源 参数 和 字符 串 表 、 使 设备 易于 定制 ， 而 无 需 修 改 任何 库 孙 

























































































数 代 码 。 
(3) 一 致 的 接口 。 即 所 有 的 设备 类 驱动 程序 库 使 用 类 似 的 API， 使 其 非常 简捷 地 在 它们 
之 间 移 动 。 





④ 最 小 的 应 用 程序 开销 。 即 绝 大 多 数 的 USB 处 理 都 是 在 类 驱动 程序 中 进行 的 ， 低 层 只 
用 于 处 理应 用 程序 中 的 数据 读 / 写 。 

@) 可 选 配 的 USB 缓冲 区 对 象 可 用 来 进一步 简化 数据 发 送 和 接收 。 即 使 用 USB 缓冲 区 ， 
与 设备 类 驱动 程序 的 互动 可 变 为 一 个 简单 的 读 / 写 API， 而 无 需 状 态 机 来 确保 在 正确 的 时 间 
发 送 或 接收 数据 。 

⑥ 设备 类 驱动 程序 的 API 完全 封装 了 底层 USB 设备 和 USB 驱动 程序 的 API， 使 应 用 程 
序 只 有 一 个 单一 的 API 接口 。 

折 中 这 些 优 势 ， 要 求 应 用 程序 开发 人 员 在 使 用 设备 类 驱动 程序 库 API 时 应 注意 以 下 
限 制 : 

① 当 设备 类 驱动 程序 API 在 使 用 时 ， 不 可 调用 其 他 任何 的 USB 层 。 

② 设备 类 驱动 程序 不 支持 切换 配置 。 

注意 ;目前 提供 的 设备 类 了 驱动 程序 ,允许 创 建 一 个 通用 的 大 容量 设备 、 一 个 通信 设备 类 
设备 (虚拟 串口 ) 和 人 机 接口 设备 类 设备 〈 和 鼠标 、 键 盘 、 游 戏 杆 等 ) ， 也 包括 用 于 复合 设备 
的 特殊 类 了 驱动 程序 。 作 为 一 个 包装 ， 允 许 在 一 台 设 备 中 使 用 多 个 设备 类 驱动 程序 。 
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4) USB 设备 类 API (USB Device Class API) : 在 某 些 情况 下 ， 使 用 标准 的 设备 类 可 创建 
多 种 不 同和 多 样 的 设备 ， 在 该 状况 下 ， 一 个 额外 的 API 层 将 为 专门 的 设备 提供 进一步 的 操作 
和 简化 应 用 程序 的 接口 。 例 如 ， 人 机 接口 设备 (HID) 类 就 是 这 样 的 一 个 类 ， 用 于 支持 多 种 
设备 ， 包 括 键盘 、 游 戏 杆 、 鼠 标 和 游戏 控制 器 等 。HID 设备 类 驱动 程序 是 非常 通用 的 ， 可 文 
持 尽 可 能 宽泛 的 设备 。 为 了 简化 使 用 的 接口 ， 它 提供 特定 的 API 来 支持 BIOS 兼容 的 键盘 和 
鼠标 操作 ， 使 用 鼠标 类 API 替代 基本 的 HID 类 驱动 程序 API， 因 而 ， 应 用 程序 可 使 自己 对 于 
USB 主机 使 用 非常 简单 的 接口 作为 一 个 鼠标 可 见 ， 包 括 初始 化 调用 和 鼠标 移动 或 按钮 按 下 
的 通知 调用 等 。 在 使 用 键盘 设备 类 的 API 时 ， 应 用 程序 可 使 用 单一 API 发 送 按键 以 及 间断 信 
息 到 主机 而 无 需 知道 底层 结构 和 USB HID 协议 ， 因 而 可 大 大 简化 USB 设备 的 编程 及 操作 。 


Driverlib 库 困 数 介绍 


USB 固件 库 提供 一 组 用 于 访问 Tiva USB 设备 、 主 机 和 /或 设备 、 或 OTG 控制 器 的 API 画 
数 。 根 据 USB 控制 器 在 微 控制 器 中 提供 的 功能 ， 可 将 API 函数 分 成 几 组 : USBDev 、USB- 
Host 、USBOTG 、USBEndpoint 和 USBFIFO。 具 有 一 个 USB 器 件 控制 器 的 微 控 制 器 只 可 使 用 
USBDey 组 的 API; 仅 含 一 个 USB 主机 控制 器 的 微 控 制 器 只 能 使 用 USBHOST 组 中 的 API; 仅 
含 一 个 OTG 接 日 的 微 控 制 器 使用 USB OTG 组 的 API。 对 于 USB OTG 控制 器 ， 一 旦 配置 了 
USB 控制 器 的 模式 ， 将 使 用 设备 或 主机 的 API。 其 余部 分 的 APIs 既 可 用 于 USB 主机 控制 器 ， 
也 可 用 于 USB 设备 控制 器 。USBEndpoint API 用 于 配置 和 访问 端点 ， 而 USBFIFO API 用 手配 
置 FIFOs 的 大 小 和 位 置 。 也 就 是 说 ， 采 用 Driverlib 固件 库 函 数 即 可 搭建 14. 1 节 介 绍 的 USB 
2.0 的 内 容 。 该 驱动 程序 包含 在 Driverlib/usb. c 中 。Driverlib/usb. h 定义 了 USB API 函数 的 
定义 。 

USB 控制 器 API 根据 使 用 条 件 在 driverlib 库 手册 中 的 归 类 如 图 14-10 所 示 。 

下 面 仅 就 实现 USB 基本 功能 的 API 函数 集 “ 通 ” 自 34[USB Controler ] 


用 USB API 函数 ”和 “ 带 有 uDMA 控制 器 的 USB 国 34.1 Introduction や 


本 = 

站 た Ri 34.2 General USB API Functions 
操作 的 功 能 作 一 简 单 介绍 四 而 对 于 USB 锦上添花 34.3 Using USB with the uDMA Controller 
的 API 函数 集 “ 带 有 DMA 控制 器 的 USB 操作 ”， 


34.4 Using the integrated USB DMA Controller 
“USB 连接 电源 管理 ”与 “ULPI” 所 包含 的 API 功 


34.5 USB Link Power Management Functions 
能 简介 ， 请 参考 Driverlib 库 的 USB 部 分 。 有 关 USB 


驱动 库 的 函数 功能 说 明 ， 请 参考 书后 第 14 章 附 录 。 


和 4.7 rar Eyample “到 
dirverlib 库 API 归 类 
(1) 通用 USB API 函数 


它 包 括 70 个 用 于 底层 /中 层 的 API 函数 ， 提 供 图 14_10 UsB API 在 手册 中 的 归 类 
了 实现 USB 器 件 或 USB 主机 堆栈 所 需 的 全 部 函数 。 
基于 使 用 中 的 USB 控制 器 类 型 API 可 抽象 出 IN/OUT 端点 的 特征 。 使 用 IN/OUT 术语 的 任 
何 API 函数 符合 这 些 条 款 的 标准 USB 描述 。 例 如 ， 对 于 一 个 只 具有 设备 接口 的 微 控 制 器 上 
的 OUT 端点 , 实际 上 它 会 通过 该 端点 来 接收 数据 ， 而 对 于 有 一 个 主机 接口 的 微 控 制 器 ， 实 
际 上 它 也 将 在 OUT 端点 上 发 送 数据 。 

USB 控制 器 具有 一 个 可 分 配给 端点 的 全 局 FIFO 存储 器 空间 。FIFO RAM 总 的 空间 大 小 
为 2048 字 节 或 4096 字 节 ， 这 取决 于 所 使 用 的 Tiva 设备 。 要 特别 注意 的 是 : 存储 器 中 的 前 
64 个 字 节 专门 用 于 控制 传输 的 端点 0。 剩 余 的 1984 或 4032 个 字 节 可 根据 应 用 程序 的 需要 来 
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配置 。 通 常 在 应 用 的 开始 进行 FIFO 的 配置 ， 而 一 旦 进入 使 用 就 不 可 对 其 配置 进行 修改 。 可 
通过 USBFIFOConfig( ) API 函数 来 配置 每 一 个 端点 的 FIFO 起 始 地 址 和 大 小 。 

(2) 帯 有 uDMA 控制 器 的 USB 操作 

USB 控制 器 可 以 和 uDMA 一 起 用 于 主机 /设备 控制 器 的 数据 接收 与 发 送 。uDMA 控制 器 
不 可 访问 端点 0, 然而， 所 有 其 他 端点 都 可 使 用 UDMA 控制 器 访问 。USB 的 uDMA 通道 号 
由 下 列 值 定义 : 

e DMA_ CHANNEL_USBEP1RX 。 

e DMA CHANNEL_USBEP1TX 。 

e DMA_ CHANNEL_USBEP2RX 。 

e DMA_ CHANNEL_USBEP2TX 。 

e DMA CHANNEL_USBEP3RX 。 

e DMA_ CHANNEL_USBEP3TX 。 

对 于 超过 8 个 端点 设备 ， 必 须 使 用 USBEndpointDMAChannel( ) 糸数 把 3 个 DMA 发 送 通 
道 和 DMA 接收 通道 中 的 一 个 分 配给 所 需 的 端点 。 由 于 uDMA 控制 器 把 传输 看 作 发 送 或 接 
收 ， 并 且 USB 控制 器 对 IN/OUT 事务 进行 操作 ， 则 需 小 心 使 用 正确 的 uDMA 通道 与 正确 的 
端点 。USB 主机 IN 消 所 和 USB 设备 OUT 端点 都 可 以 使 用 接收 uDMA 通道 ， 而 USB 主机 
OUT 端点 和 USB 设备 IN 端点 可 使 用 UDMA 发 送 通道 。 

当 配 置 端 点 时 ， 需 另 外 的 DMA 设置 。 当 调用 USBDevEndpointConfig( ) 隙 函数 来 配置 一 个 
端点 时 需 使 用 uDMA ， 额 外 的 标志 必须 被 添加 到 ulFlags 参数 。 这 些 标志 是 USB_EP_DMA_ 
MODF 0 或 USB_FP_DMA_MODE_1 其 中 之 一 ， 以 控制 DMA 事务 的 模式 ， 一 旦 包 准 备 就 绪 
可 使 用 USB_EP_AUTO_SET 允许 数据 自动 传输 。 在 使 用 USB_EP_DMA_MODE_0, 当 全 部 佐 逢 
完成 时 ，USB 控制 器 只 产生 一 个 中 断 。 因 此 ， 应 用 程序 在 配置 DMA 传输 之 前 必须 知道 完整 传 
输 的 大 小 。 在 USB_FEP_DMA_MODE_1， 只 有 当 数 据 包 传输 完成 和 短 包 中 断 时 ，USB 控制 器 才 
会 发 出 DMA 请 求 。 短 包 数 据 仍 保留 在 USB FIFO ， 因 此 必须 启动 FIFO 中 数据 的 另 一 次 传输 。 

下 面 是 一 个 有 关 带 uDMA 的 端点 配置 的 例子 。 

(1) 设备 IN 端点 的 配置 

// 
// 端 点 1 是 使 用 DMA 的 一 个 设备 模式 的 BULK IN 端点 
// 
USBDevEndpointConfigSet( USBO_BASE,USB_EP_1.,64, 
(USB_EP_MODE_BULK | USB_EP_DEV_IN | 
USB_EP_DMA_MODE_0 | USB_EP_AUTO_SET) ) ; 


将 端点 1 配置 为 发 送 通道 


// 
// 将 DMA 设置 为 USB 发 送 

// 

DMAChannelAttributeClear( DMA_CHANNEL_USBEP1TX JDMA_CONEIC_ALL) : 
// 

// 使 能 uDMA 突 发 模式 

// 
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(3) 


(4) 


(5) 


DMAChannelAttibuteSet( DMA_CHANNEL_USBEP1TX ,DMA_CONFIG_USEBURST ) ; 


// 


// 数 据 长 度 为 8 位 且 源 中 有 一 个 字 节 的 增 量 


// 目 标 作 为 一 个 FIFO 没有 增 量 


// 








DMAChannelControlSet( DMA_CHANNEL_USBEPITX JDMA_DATA_SIZE_8JDMA_ADDR_INC_8, 
DMA_ADDR_INC_NONE,DMA_ARB 64.0): 


启动 端点 1 的 数据 传输 


// 





// 设 置 要 传输 数据 的 地 址 和 长 度 




















// 


DMAChannelTransferSet(DMA_CHANNEL_USBEP1TX ,DMA_MODE_BASIC ,pData , 


// 
// 启 动 传输 
// 


USBFIFOAddr( USBO_BASE ,USB_EP 1) ,64 ) ; 


DMAChannelEnable(DMA_CHANNEL_USBEP1TX ) ; 


中 断 处 理 


if( (g_ulFlags & EP1_DMA_IN_PEND) && 


(DMAChannelModeGet( DMA_CHANNEL_USBEP1TX ==DMA_MODE_STOP) ) 


| 
// 


// 处 理 DMA 完成 情况 


// 
| 
// 


// 获 取 中 断 状态 


// 


ulStatus = USBIntStatusEndpoint( USBO_BASE ) ; 
if(ulStatus & USB_INTEP_DEV_IN_1) 


| 
// 


// 处 理 程序 的 传输 完成 情况 


// 


| 


将 端点 1 配置 成 接收 通道 


// 








alE 
Ur 


日 DMA 的 设备 模式 BULK OUT 端 ， 





// 端 点 1 是 
// 





个 使 








USBDevEndpointConfigSet( USBO0_BASE,USB_EP_1.,64, 


(USB_EP_DEV_OUT | USB_EP_MODE_BULK | 
USB_EP_DMA_MODE_1 | USB_EP_AUTO_CLEAR) ) ; 
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(6) 配置 端点 1 发 送 通 道 


// 
// 清 除 任何 uDMA 设置 
// 
DMAChannelAttributeClear( DMA_CHANNEL_USBEP1RX,DMA_CONEIC_ALL) : 
DMAChannelAttributeSet(DMA_CHANNEL_USBEP1RX ,DMA_CONEIC_USEBURST) ; 
DMAChannelControlSet(DMA_CHANNEL_USBEP1RX ,」DMA_DATA_SIZE 8, 
DMA_ADDR_INC_NONE,DMA_ADDR_INC_8.DMA_ARB 64.0): 


(7) 启动 端点 1 的 数据 请 求 















































AZ 
// 配 置 要 传输 数据 的 地 址 和 长 度 。 传 输 从 USB FIFO 端点 0 到 g_DataBufferIn 
// 


DMAChannelTransferSet( DMA_CHANNEL_USBEPIRX, DMA_MODE_BASIC, 
USBFIFOAddr( USBO_BASE ,USB_FP_1) ,g_DataBufferIn, 





64); 
// 
// 使 能 uDMA 通 道 , 井 等 待 数 据 
// 


DMAChannelEnable(DMA_CHANNEL_USBEP1RX ) ; 


(8) 带 短 包 的 中 断 处 理 


// 
/获取 当前 的 中 断 状 态 
// 


ulStatus = USBIntStatusEndpoint( USBO_BASE ) ; 
if(ulStatus & USB_INTEP_DEV_OUT_1) 

| 

// 

// 短 包 处 理 

Zp 





1 
1 


else if((g_ulFlags & EP1_DMA_OUT_PEND ) && 

(DMAChannelModeGet( DMA_CHANNEL_USBEPIRX) ==DMA_MODE_STOP) 
| 

// 

// 处 理 DMA 完成 情況 

シグ 3 

// 

// 如 果 需 要 重启 DMA 接收 

// 





1 
i 


下面 是 Driverlib 库 例 程 片 段 . 
278 





// ボネ ネネ ポポ ポポ ポポ ボネ ボボ ポポ ボボ ポポ ポポ ボボ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ボネ ポポ 
3 rl 洲 -A 
// 实 现 端 点 配置 与 数据 传输 


// ネネ ボネ ネネ ポポ ボネ ポポ ボネ ボボ ポポ ボボ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ネネ ポポ 





// 
// 将 端点 1 配置 成 Bulk IN 端点 ,最 大 包 长 度 为 64 个 字 节 
// 


USBDevEndpointConfigSet(USBO_BASE ,USB_EP 1 ,64 ， // 最 大 包 长 度 
DISABLE_NAK_LIMIT, 




















USB_EP_MODE_BULK | // 批 量 ( Bulk ) 模式 
USB_EP_DEV_IN) , // 设 备 模式 的 IN 端点 
// 
// 将 FIFO 配置 成 起 始 地 址 为 64 的 设备 IN 端点 ,并 且 它 的 包 长 度 为 64B 
// 


USBFIFOConfig( USBO_BASE, USB_EP_1,64,USB_FIFO_SZ_64,USB_EP_DEV_IN) ; 





LA 

// 将 数据 存放 到 FIFO 中 
pa 

USBEndpointDataPut( USBO_BASE, USB_EP_1 ,pucData ,64) ; 

// 

// 启 动 数据 的 传输 

// 

USBEndpointDataSend( USBO_BASE ,USB_FP 1,USB_TRANS_IN ) ; 


USBlib 库 困 数 介绍 


德州 仪器 USB 库 用 于 创建 USB 设备 、 主 机 或 OTG 应 用 程序 的 一 组 数据 类 型 和 水 数 。 它 
提供 了 多 个 编程 接口 ， 从 仅 提取 底层 USB 控制 器 硬件 的 最 薄 层 到 为 特定 器 件 提 供 简单 AP 
支持 的 高 级 接口 。USB 库 的 内 容 和 相关 的 头 文件 分 为 四 个 主要 组 : 

① 通用 函数 . 可 用 于 设备 、 主 机 和 双 模 式 应 用 程序 中 。 包 含 解析 USB 描述 符 和 USB 库 
的 配置 特点 。 

② 设备 模式 的 特定 函数 : 提供 所 有 USB 器 件 应 用 程序 需要 的 类 独立 功能 ， 例 如 主机 连 
接 信 令 和 对 标准 描述 符 请 求 的 响应 。 

③ 主机 模式 的 特定 函数 : 提供 所 有 USB 主机 应 用 程序 需要 的 类 独立 功能 ， 例 如 器 件 检 
測 和 枚挙 以 及 端 点 管 理 。 

④ 模式 检测 与 控制 函数 ， 用 于 USB 的 操作 模式 检测 ， 如 检测 USB 设备 间 的 接 入 ， 以 及 
监测 VBUS 和 ID 引 脚 信号 等 。 

此 外 ， 库 中 还 提供 驱动 程序 与 “. inf” 文 件 ， 这 将 有 助 于 开发 人 员 为 新 设备 定制 驱动 程 
序 和 “. inf” 文 件 。 

1. USBlib 目录 结构 概述 

TivaWare 2.0 版 软件 的 USBlib 目录 结构 如 图 14-11 所 示 。 

2. 通用 API 

下 面 介 绍 USB 库 中 通用 API 的 数据 类 型 和 函数 ， 不 包括 特定 于 USB 主机 、 设 备 或 OTG 
操作 。 通用 API 的 函数 和 类 型 描述 可 分 为 三 大 类 : 
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回 Makefile readme 


] usbbuffer ncdc 
| usbdfu na 


| a 
7 
] usb-ids 通用 API Mboardmap usblib.ewp 
usblib 、 -SdxX usblib.uvg 
Usblib.uvoPs aa Sy usblib_usblib.deph 
h] usblibpriv usbmode Th usbmsc 

















14-11 USB 库 的 目录 结构 


1) USB 标准 类 型 定义 (USB2. 0 规范 第 9 章 ) 和 函数 解析 。 

2) 主机 /设备 模式 切换 为 OTG 或 双 模 式 应 用 。 

3) USB 设备 类 头 文件 。 

通用 API 的 源 代码 (如 图 14-11 所 示 ) 如 下 : 

1) usblib. h: 包含 USB 库 中 所 有 数据 类 型 和 定义 (将 库 作 为 一 个 整体 ) 的 主 头 文件 。 
并 且 包 含 通用 API 函数 的 原型 以 及 USB 库 的 所 有 客户 端 应 用 程序 都 应 包含 该 头 文件 。 

2) usb -ids. h: 包含 评估 套件 中 每 个 USB 例子 的 德州 仪器 的 厂商 号 (VID) 和 产品 号 
(PID) 的 头 文件 。 

3) usbmsc. h: 包含 USB 大 容量 存储 类 定义 的 头 文件 。 

4) usbcdc.h: 包含 USB 通信 设备 类 定义 的 头 文件 。 

5) usbhid. h: 包含 USB 人 机 接口 设备 类 定义 的 头 文件 。 

6) usblibpriv h: 用 于 在 USB 文库 的 各 种 组 件 中 共享 变量 和 定义 的 私有 头 文件 ， 客 户 端 
应 用 程序 不 应 包括 这 个 头 文件 。 

7) usbdesc. c: 解析 USB 描述 符 函 数 的 源 代 码 。 

8) usbbuffer.c: 用 于 支持 一 些 应 用 中 USB 端点 数据 流 缓冲 区 的 一 组 函数 源 代码 。 

9) usbringbuf. c: 实现 简单 环 缓冲 区 的 一 组 函数 源 代码 。 

10) usbmode. c: 用 于 在 主机 和 设备 操作 之 间 切 换 的 一 组 函数 源 代码 。 

11) usbtick. c: 内 部 USB 库 滴答 时 钟 处 理 函 数 的 源 代码 。 此 文件 不 包含 由 应 用 程序 访问 
的 任何 功能 。 

3. 主机 API 

下 面 介绍 在 主机 模式 下 由 USB 库 提供 的 对 USB 控制 器 的 支持 。 为 了 简化 应 用 程序 与 添 
加 新 的 设备 和 设备 类 ，USB 库 为 USB 主机 控制 器 提供 了 一 个 分 层 接口 。 在 USB 库 的 顶层 提 
供 了 由 USB 库 支 持 的 方便 访问 各 类 外 设 的 应 用 程序 接口 。 下 面 这 个 层 是 处 理 每 种 类 型 设备 
细节 的 USB 主机 控制 器 的 设备 接口 ， 以 及 如 何 与 USB 主机 类 驱动 程序 进行 通信 。USB 主机 
类 驱动 程序 是 处 理 整 个 设备 类 的 基础 ， 如 HID 和 大 容量 存储 类 设备 。USB 主机 类 驱动 程序 
层 与 最 底层 的 USB 主 控制 器 驱动 程序 库 通 信 。 通 过 直接 访问 最 底层 DriverLib 中 的 函数 来 提 
供与 已 连接 的 USB 设备 进行 通信 。 

主机 接口 的 分 层 如 下 : 
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1) Device APIs (有 鼠标、 键盘 、 文 件 系统 )。 

2) USB Class Driver APIs (HID 、 大 容量 存储 、 HUB ) 。 
3 ) USB Host Controller APIs 。 

4) DriverLib USB Driver APls。 

(1) 主机 API 的 源 代码 (如 图 14-12 所 示 ) 


1) usbhost h // 在 USB 库 中 包含 主机 模式 的 函数 原型 和 数据 类 型 定义 的 头 文件 
2) usbhaudio. h // 包 含 主机 文 持 的 特定 音频 类 定义 的 头 文件 

3) usbhhid.h // 包 含 与 USB 主机 HID 类 驱动 程序 交互 所 需 定 义 的 头 文 件 

4) usbhhub. h // 包 含 与 USB 主机 Hub 类 驱动 程序 交互 所 需 定 义 的 头 文件 


5) usbhhidkeyboard.h /包含 与 USB 主机 HID 类 键盘 设备 交互 所 需 定义 的 头 文件 
6) usbhhidmouse. h /包含 与 USB 主机 HID 类 鼠标 设备 交互 所 需 定 义 的 头 文件 
7) usbhmsc. h // 包 含 主机 支持 的 特定 大 容量 存储 类 定义 的 头 文件 

8) usbhostenum. c // 由 库 提供 的 USB 主机 枚 举 函 数 的 源 代码 

9) usbhaudio. c //USB 主机 音频 类 驱动 程序 的 源 代码 





10) usbhhid. e //USB 主机 HID 类 驱动 程序 的 源 代 码 
11) usbhhub. c //USB 主机 集线器 (HUB) 类 驱动 程序 的 源 代 码 


12) usbhhidkeyboard.c //USB 主机 HID 类 键盘 设备 的 源 代码 

13) usbhhidmouse. c /USB 主机 HID 类 的 鼠标 设备 的 源 代码 

14) usbhmsc. c //USB 主机 大 容量 存储 类 驱动 程序 的 源 代码 

15) usbhscsi. c // 调 用 主机 大 容量 存储 类 驱动 程序 的 高 级 SCSI 接口 的 源 代码 


(2) 主机 专用 类 及 定义 (如 图 14-13 所 示 ) 
BF 主机 专 




















ト k ti hb TivaWare_C_Series-2.0.1.11577 on host 


usbhaudio usbhaudio p> | usbhhid 
usbhhidkeyboard 








usbhhid 


回, 蕊 


] usbhhidkeyboard 


| 
hn 
Si 
A 


EJ - ア 中 リア 


] usbhhub 自生 Host Class Driver 
.4 1 USB Events Driver 
.4.2 Hub Class Driver 


usbhhidmouse hlusbhhidmouse 


usbhhub jc] usbhmsc ] usbhmsc 





hn 
usbhost je] usbhostenum h] usbhostpriv 








5 記紀, 


3.4.3 HID Class Driver 
-4 4 Mass Storage Class Driver 
4.5 Audio Class Drivep 


.4.6 Implementing Custom Hos 
Class Drivers 


ES Host Class Driver Definitions 


usbhscsi hl usbhscsi 












































图 14-12 主 机 API 的 源 代码 图 14-13 主机 专用 类 及 定义 


由 于 USBlib 固件 库 的 手册 多 达 300 页 ， 这 里 就 不 一 一 介绍 了 ， 需 要 这 部 分 知识 的 读者 可 
以 参考 USBlib 库 手册 图 示 的 内 容 。 而 具体 用 法 可 参考 DK - TM4C123G 开发 板 提供 的 例 程 : 

1) usb_host_audio 。 

2) usb_host_keyboard 。 


3) usb_host_mouse 。 




















4) usb_host_msc。 
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4. 设备 API 函数 








下面 介 USB 库 中 提供 支持 USB 设备 应 用 程序 的 各 种 API 层 。 一 些 编程 接口 提供 了 从 
仅 抽象 底层 USB 控制 器 硬件 的 最 薄 层 到 提供 简单 API 支持 的 特定 设备 接口 的 高 层 。 

USB 库 包 含 了 与 开发 USB 设备 应 用 程序 相关 的 四 个 API 层 。 从 上 往 下 向 堆栈 移动 ， 虽 
然 每 个 API 层 给 编程 USB 应 用 程序 提供 了 更 大 的 灵活 性 ， 但 使 用 较 低 层 需要 耗费 更 多 的 时 











间 来 实现 同样 的 功能 。 与 USB 库 的 主机 编程 接口 类 似 ， 设 备 接口 的 分 层 如 下 : 
1) Device Class APls。 

2) Device Class Driver APls 。 

3 ) The USB Device API。 

4) The USB DriverLib API。 

(1) 设备 API 的 源 代码 (如 图 14-14 所 示 ) 
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1 ) usbdbulk. h 
2 ) usbdcdc. h 
3 ) usbdhid. h 


4 ) usbdhidkeyb. h 
$ ) usbdhidmouse. h 
6 ) usbdevicepriv. h 


7 ) usbdenum.c 

8 ) usbdhandler. c 
9 ) usbdconfig. c 
10 ) usbdcdesc. c 
11 ) usbdbulk. c 
12 ) usbdcdc. c 
13 ) usbdhid.c 


14 ) usbdhidkeyb. c 








» ti » TivaWare_C_Series-2.0.1.11577 r Ce 





c] usbdaudio hl bio c] usbdbulk トペ 
h] usbdbulk cj usbdcdc h] usbdcdc 

c] usbdcdesc ce] usbdcomp h] usbdcomp 

cj usbdconfig cj] usbddfu-rt h] usbddfu-rt 

c] usbdenum h] usbdevice h] usbdevicepriv 
c] usbdhandler ce] usbdhid h usbdhid 

cj usbdhidkeyb hl usbdhidkeyb c] usbdhidmouse 
h] usbdhidmouse cj] usbdmsc h] usbdmsc 

















較 14-14 设备 API 的 源 代码 


// 定 义 USB 通用 批量 设备 类 驱动 程序 API 的 头 文件 

// 定 义 了 USB 通信 设备 类 (CDC) 设备 类 驱动 程序 API 的 头 文件 
// 定 义 USB 人 机 接口 设备 (HID) 设备 类 驱动 程序 API 的 头 文件 
// 定 叉 USB HID 键盘 设备 类 API 的 头 文件 

// 定 义 USB HID 鼠标 设备 类 API 的 头 文件 

// 用 于 在 USB 文库 的 各 种 组 件 中 共享 变量 和 定义 的 私有 头 文件 
// 客 户 端 应 用 程序 不 应 包括 这 个 头 文件 

// 由 库 提供 的 USB 设备 枚 举 函数 的 源 代 码 

//USB 设备 中 断 处 理 程序 的 源 代码 

//USB 设备 配置 函数 的 源 代码 

// 解 析 配 置 描述 符 定义 函数 的 源 代码 (与 USB 设备 API 一 起 使 用 ) 
//USB 通用 批量 设备 类 驱动 程序 的 源 代码 

//USB 通信 设备 类 (CDC) 设备 类 驱动 程序 的 源 代码 

//USB 人 机 接口 设备 (HID) 设备 类 驱动 程序 的 源 代码 

//USB HID 键盘 设备 类 的 源 代码 





























15) usbdhidmouse. c //USB HID 鼠标 设备 类 的 源 代码 
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图 14-15 设备 专用 类 及 定义 

















图 14-15 的 内 容 较 多 ， 这 里 就 不 一 一 介绍 了 ， 需 要 用 到 这 部 分 知识 的 读者 可 以 参考 USBlib 
库 手 册 的 图 示 部 分 。 而 具体 USB 设备 API 的 用 法 可 参考 T 提供 的 例 程 ， 比 如 EK - 
TM4C123GXL (LaunchPad) 开发 板 提供 了 usb_dev_bulk 和 usb_dev_serial 两 个 有 关 USB 设备 
的 例 程 ，DK -TM4C123G 开发 板 除 这 两 个 例 程 外 还 提供 了 usb_dev_keyboard 和 usb_dev_msc 
两 个 USB 设备 例 程 。 下 面 将 以 usb_dev_bulk 例 程 来 介绍 设备 专用 库 、 描 述 符 、 底 层 驱 动 等 
的 用 法 。 

注意 : 在 开发 基于 USB 的 应 用 时 ， 原 则 上 尽量 采用 TI USBlib 库 提 供 的 专用 类 API 来 实 
现 ， 对 目前 还 无 法 实现 的 功能 ， 可 以 使 用 较 低 层 的 现 有 固件 库 函 数 来 定制 。 








本 小 节 通 过 一 个 TI 提供 的 uab_bulk_exmaple 例 程 来 介绍 基于 USB 应 用 的 程序 设计 及 
测试 。 

1. USB 硬件 连接 

USB 硬件 连接 如 图 14-16 所 示 。 





J9 
CON-USB-MICROAB 








[EB1] 











I 


图 14-16 LaunchPad 开发 板 的 USB 硬件 接线 
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2. usb_bulk 程序 及 测试 
(1) usb_bulk_structs. c 说 明 


// ポ ネ ホホ ホホ ポポ ポポ ホネ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホネ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホ ポポ ポポ ホネ ポポ ホホ ポポ ホホ ポポ ホネ ポ ポポ ポポ ネネ 
// 文 件 名 . usb_bulk_structs. c 

// 来 源 :TI 例 程 

// 功 能 :定义 批量 USB 设备 的 数据 结构 

// 程 序 框架 ,如 图 14-17 所 示 















































/* 
基于 选择 的 bulk 设 备 类 ， 实 现 所 需 的 描述 符 
bulk 设 备 初 始 化 与 结构 定制 
定制 接收 缓冲 区 《从 USB 的 视角 ) 
定制 发 送 缓冲 区 “从 USB 的 视角 ) | 
14-17 usb_bulk_structs. c 程序 框图 
*/ 


//Tiva 2.0 版 EK - TM4C123GXL 固件 包 例 程 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





#include < stdint. h > 

#include < stdbool. h > 

#include "inc/hw_types. h" 

#include " driverlib/usb. h" 

#include "usblib/usblib. h" 

#include "usblib/usb - ids. h" 
#include "usblib/device/usbdevice. h" 
#include "usblib/ device/ usbdbulk. h" 
#include "usb_bulk_structs. h" 


ノノ / ネネ ホネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ネ ポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポ ネ ポポ ネネ ポポ ポポ ネネ ポポ 
LL 、\ 五 一 

// 设 备 支 持 的 语言 

ノノ / ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ネネ ポポ ネネ 


const uint8_t g_pui8LangDescriptor[ | = 
| 

4。 

USB_DTYPE_STRINC, 

USBShort( USB_LANG_EN_US) 
上 


// ネネ ネネ ネネ ボネ ボネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





上 秆 | AH ーー 
// 制 造 商 字符 串 
// ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ネネ ポポ 


const uint8_t g_pui8ManufacturerString[ ] = 


| 
(17 +1) * 2, 
USB_DTYPE_STRINC, 
「T 05 9 05 メ 05 す 20508.07 OT 05T 058 20。 
OR OT 05 mm 05 6 の 0705T 05 き 0。 


っ 5 


ノノ / ネネ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネ ポポ ポポ ネネ ポポ 
ロ ニン タ を 

// 产 品 字符 串 

// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 


const uint8_t g_pui8ProductString[ ] = 


| 
(19 +1) * 2， 
USB_DTYPE_STRING, 
'G 0! 050! 6 0 ,0,7 ,0,;¢ ,00B ,0， 
,010R ,0 0D,0e ,0'v ,0,1 ,0,¢d ,0, 
'8 ,0 


// ネネ ポポ ホネ ポポ ポポ ネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ネネ ポ ネ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 
= ロー ビラ を 

// 序 列 号 字符 串 

// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 


const uint8_t g_pui8SerialNumberString[ | = 


| 
(8+1) * 2， 
USB_DTYPE_STRINC, 
"1 ,0,;2 ,0,;3 ,0;4 .0! ダ ,0!6 ,0;7 ,0,8 ,0 


// ネネ ホネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ネ ポ ポポ ネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ネ ポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 
が デン 
// 数 据 接口 描述 字符 串 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ネネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボ ポポ ポポ ポポ ネネ ポポ 





0 


const uint8_t g_pui8DatalnterfaceString[ ] = 


| 
(19 +1) * 2， 
USB_DTYPE_STRING, 
BO ,0 OLE ,0 ,0,D ,0,a ,0,1t ,0, 
"ad ,0 0!T OPT ,Ot ,O00 ,0,1 ,0,f ,0, 
'd ,0'd ,05 8 ,0 


// ネネ ボネ ネネ ポ ボネ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 
EL AAA ロロ 
// 配 置 描述 字符 上 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ネネ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 











I 

















const uint8_t g_pui8ConfigString| ] = 


| 
(23 +1) * 2， 


285 


286 


USB_DTYPE_STRING, 
BO ,0 OK 0 0D,0a ,0 ,0, 
0 0000 ,0,0 ,0 ,0,f ,0,1 ,0,g ,0, 
cd 0 ,0 ad ,0 t ,0 ,0,0 0 1 ,0 

1 


1 5 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
いな な だ > = 长 
// 描 述 符 的 字符 串 表 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ネネ ポポ 








const uint8_t * const g_ppui8StringDescriptors[ ] = 
| 
g_pui8LangDescriptor, 
g_pui8 ManufacturerString , 
g_puiSProductString , 
g_Pui8SerialNumberString , 
g_Dui8DatalnterfaceString , 
g_pui8ConfigString 
ke 


#define NUM_STRING_DESCRIPTORS ( sizeof(g_ppui8StringDescriptors )/ \ 
sizeof( uint8_t * ) ) 


// ネネ ボネ ネネ ポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


// 


//bulk 设备 初始 化 与 结构 定制 。 因 此 ,可 在 bulk 设备 类 驱动 程序 和 应 用 程序 代码 之 间 使 用 USBBuffers 
/7 函数 指针 和 回调 数据 值 被 设置 为 插入 到 每 一 个 数据 信道 ,发 送 和 接收 缓冲 区 中 。 在 恰当 的 缓冲 
// 区 中 ,bulk 通道 的 callback 被 设置 成 相关 的 通道 函数 ,以 及 回调 数据 被 设置 成 指向 通道 的 实例 
// 数 据 。 反 过 来 ,缓冲 区 的 callback 又 设置 为 应 用 程序 的 函数 和 回调 数据 设置 成 该 bulk 实例 结构 

ング 人 キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ エキ キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ 
extern const tUSBBuffer g_sTxBuffer: 


extern const tUSBBuffer g_sRxBuffer: 






















































































tUSBDBulkDevice g_sBulkDevice = 

| 

USB_VID_TI_1CBE, 
USB_PID_BULK , 

300 , 
USB_CONEF_ATTR_SELF_PWR, 
USBBufferEventCallback, 
( 
U 





void * )&g_sRxBuffer, 
SBBufferEventCallback , 

(void * )&g_sTxBuffer, 
g_DpuiSStringDescriptors ， 
NUM_STRINC_DESCRIPTORS 





| 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 
// 接 收 缓冲 区 (从 USB 的 视角 ) 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ボボ ポポ ポポ ボボ ネネ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 


uint8_t g_pui8USBRxBuffer| BULK_BUFFER_SIZE ] ; 


(2) 


uint8_t g_pui8 RxBufferWorkspace| USB_BUFFER_WORKSPACE_SIZE ] ; 
const tUSBBuffer g_sRxBuffer = 
| 





false, // 这 是 一 个 接收 缓冲 区 
RxHandler, //pfnCallback 

(void * )&g_sBulkDevice, // 回 调 数 据 是 设备 指针 
USBDBulkPacketRead , //pfnTransfer 
USBDBulkRxPacketAvailable , //pfnAvailable 

(void * )&g_sBulkDevice, //pvyHandle 
g_Dul8USBRxBuffer , //pi8 Buffer 
BULK_BUFEER_SIZE , //ui32 BufferSize 
g_pui8RxBufferWorkspace //pvWorkspace 


| 


ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ: 
// 发 送 缓冲 区 (从 USB 的 视角 ) 

ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ: 
uint8_t g_pui8USBTxBuffer| BULK_BUFFER_SIZE ] ; 

uint8_t g_pui8TxBufferWorkspace[ USB_BUFFER_WORKSPACE_SIZE ] ; 

const tUSBBuffer g_sTxBuffer = 

| 





true, // 这 是 一 个 发 送 缓冲 区 
TxHandler, //pfnCallback 

(void * )&g_sBulkDevice, // 回 调 数 据 是 设备 指针 
USBDBulkPacketWrite, //pfnTransfer 
USBDBulkTxPacketAvailable , //pfnAvailable 

(void * )&g_sBulkDevice, //pvyHandle 
g_pui8USBTxBuffer, //pi8 Buffer 
BULK_BUFFER_SIZE, //ui32 BufferSize 
g_pui8TxBufferWorkspace //pvWorkspace 


Hs 
usb_dev_bulk. c 介绍 


クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ : 
// 文 件 名 nsb_dev_bulk. c - Main routines for the generic bulk device example. 

// 来 源 :TI 例 程 

// 功 能 : 

//1 这 个 例子 提供 一 个 通用 的 USB 设备 实现 与 主机 简单 的 bulk 数据 传输 

//1 该 设备 使 用 供应 商 特 定 的 类 ID ,并 支持 单一 bulk IN 端点 和 单一 bulk OUT 端点 

//! 从 主机 接收 到 的 数据 被 假定 为 ASCII 文本 ,并 以 大 小 写 颠 倒 的 方式 回 显 所 有 字母 

//1 设 备 的 Windows INF 文件 在 C./TL/TivaWare C 系列 /windows_drivers 目录 下 。 这 个 INF 包含 在 
//! Windows XP 和 Vista 的 PC 上 安装 WinUSB 子 系统 所 需 的 信息 。WinUSB 是 Windows 子 系统 ， 
LA! 其 允许 在 用 户 模 式 下 应 用 程序 访问 USB 设备 而 不 需要 供应 商 特定 的 内 核 模式 驱动 程序 。 这 个 
//! Windows 命令 行 应 用 程序 例 程 (usb_bulk_example) 展示 了 如 何 与 bulk 设备 连接 与 通信 
//! 需 安装 USB Windows 端 例 子 包 “SW - USB - WIN”, 可 在 http ://www. ti. com/tivaware 网 址 下 载 
//1 使 用 微软 的 VisualStudio 2008 包含 的 工程 文件 就 可 以 构建 这 个 例 程 。 此 应 用 程序 的 源 代码 可 
/LI 以 在 目录 TivaWare -for-C-Series/tools/usb_bulk_example 中 找到 

/* 
USB 通用 Bulk 设备 模型 如 图 14-18 所 示 。 
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图 14-18 USB 通用 Bulk 设备 模型 























*/ 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ チキ キキ キキ : 
#include < stdbool. h > 

#include < stdint. h > 

#include "inc/hw_ints. h" 

#include "inc/hw_memmap. h" 

#include "inc/hw_types. h" 

#include " driverlib/debug. h" 

#include " driverlib/fpu. h" 

#include " driverlib/gpio. h" 

#include " driverlib/interrupt. h" 

#include " driverlib/pin_map. h" 

#include " driverlib/sysctl. hy" 

#include " driverlib/systick. h" 

#include " driverlib/timer. h" 

#include " driverlib/uart. h" 

#include " driverlib/rom. h" 

#include "usblib/usblib. h" 

#include " usblib/usb - ids. h" 

#include " usblib/device/usbdevice. h" 

#include " usblib/device/usbdbulk. h" 

#include " utils/uartstdio. h" 

#include " utils/ustdlib. hy" 

#include "usb_bulk_structs. h" 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ : 
// 定 义 系统 时 钟 速率 表示 每 秒 的 滴答 数 和 毫秒 周期 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ キキ: 
#define SYSTICKS_PER_SECOND 100 

#define SYSTICK_PERIOD_MS (1000/SYSTICKS_PER_SECOND ) 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ : 
// 全 局 系统 时 钟 计数 器 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 











volatile uint32_t g_ui32SysTickCount =0: 
ノノ 未来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 水 


// 跟 踪 发 送 和 接收 计数 值 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


volatile uint32_t g_ui32TxCount =0: 


volatile uint32_t g_ui32RxCount = 0 ; 

#ifdef DEBUG 

uint32_t g_ui32UARTRxErrors =0: 

#endif 

7 ホ ポ ネ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポ ホ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ポ ネ ポポ ホホ ポポ ホホ ポポ ホネ ポポ ポポ ネネ 
// 与 调试 相关 的 定义 和 声明 

// 如 果 在 调试 过 程 中 定义 了 DEBUG ,可 通过 UARTO 端口 输出 调试 结果 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ: 
#ifdef DEBUC 

メグ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボド 
// 映 射 所 有 的 调试 打印 可 调用 UARTprintf 调试 版 本 

メ / ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボド 
#define DEBUG_PRINT UARTprintf 


#else 











ノノ 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 ボ 
// 编 译 所 有 调试 打印 调用 发 布 版 本 

ノノ 水 洲 米 米 洲 米 米 沙洲 米 米 炒米 炒米 炒米 炒米 炒米 炒米 米 沙 米 米 米 洲 米 玉米 米 米 米 米 米 米 米 炒米 炒米 炒米 玉米 玉米 米 米 炒米 炒米 炒米 米 米 米 米 炒米 炒米 炒米 炒米 
#define DEBUG_PRINT while(0)((int ( * ) (char *,... ) )0) 

#endif 

// 玉米 炒米 炒米 米 水 米 炒米 米 米 炒米 米 米 炒米 炒米 炒米 米 沙 米 炒米 炒米 玉米 炒米 米 米 炒米 米 米 米 沙洲 炒米 玉米 玉米 米 米 炒米 炒米 炒米 米 米 米 米 炒米 炒米 炒米 炒米 
// 用 于 从 中 断 上 下 到 主 循环 文 命令 传递 的 标志 

ノノ 水 洲 米 洲 米 米 沙洲 炒米 米 米 炒米 炒米 炒米 米 米 炒米 米 沙 米 炒米 炒米 玉米 米 米 炒米 炒米 米 米 米 洲 米 炒米 玉米 炒米 米 米 炒米 炒米 炒米 米 米 米 炒米 炒米 米 炒米 炒米 
#define COMMAND_PACKET_RECEIVED 0x00000001 

#define COMMAND_STATUS_UPDATE 0x00000002 

volatile uint32_t g_ui32Flags =0; 

// 水 玉米 米 沙洲 米 沙洲 炒米 米 米 炒米 炒米 炒米 炒米 炒米 米 沙 米 炒米 炒米 玉米 炒米 米 米 炒米 米 洲 米 炒米 炒米 玉米 玉米 米 米 炒米 炒米 炒米 米 米 米 米 炒米 炒米 炒米 洲 炒 
// 指 示 已 配置 USB 的 全 局 标志 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポ ネ ポポ 



































static volatile bool g_bUSBConfigured = false: 
ンク キキ キキ ギ キキ キキ キ キキ キキ キキ キキ キテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ : 


// 当 驱动 程序 库 遇 到 错误 时 ,调用 错误 处 理 程序 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ネネ ポポ 


#ifdef DEBUG 


void 











_ error_ (char * pceFilename ,uint32_t ui32Line ) 
| 
UARTprintf( " Error at line %d of % s\n" ,ui32Line,pcFilename ) ; 
while(1) 
| 
| 
| 
#endif 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ : 
// 系 统 时 钟 计数 器 的 中 断 处 理 程序 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 








void 
SysTickIntHandler( void ) 
| 
// 更 新 系统 时 钟 计数 器 
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290 


g_ui132SysTickCount ++ ; 


1 


ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボド 
// 接 收 新 数据 并 将 其 返回 给 主机 

/ 八 参 数 psDevice 指向 设备 要 处 理 数 据 的 数据 实例 

/ 八 参 数 pui8Data 指向 USB 接收 缓冲 区 新 接收 的 数据 

/ 八 参 数 ui32NumBytes 为 待 处 理 数据 的 字 节 数 

// 当 收 到 可 从 主机 获取 数据 通知 ,调用 此 函数 

// 逐 字 节 读 出 数据 ,将 发 现 的 任何 字母 字符 大 小 写 交 换 , 然 后 把 它 写 回 到 主机 

//\ retum 返回 处 理 后 的 数据 字 节 数 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 



























































static uint32_t 
EchoNewDataToHost(tUSBDBulkDevice * psDevice ,uint8_t * pui8Data , 
uint32_t ui32 NumBytes ) 


uint32_t ui32Loop ,ui32Space , ui32Count; 
uint32_t uni32ReadIndex : 

uint32_t un32 Writelndex: 
LtUSBRingBufObject sTxRing: 











ノ / 

// 获 取 当 前 缓冲 区 信息 ,以 使 可 直接 向 发 送 缓冲 区 写 和 人 数据 
ノ / 

USBBufferInfoCet( &g_sTxBuffer,&sTxRing ) ; 

ノ / 

// 发 送 缓冲 区 中 有 多 少 空间 ? 

ノ / 

ui32Space = USBBufferSpaceAvailable( &g_sTxBuffer) ; 
ノ / 

// 这 一 次 有 多 少 个 字符 待 处 理 ? 

ノ / 


ui32Loop = ( ui32Space < ui32NumBytes ) ? ui32Space : ui32NumBytes ; 
ui32Count = un32Loop: 

// 

// 更 新 接收 计数 器 





g_u132RxCount += ui32NumBytes ; 
lp 

// 转 存 调试 信息 
メ / 
DEBUGC_PRINT( "Received %d bytes\n" ,ui32NumBytes ) ; 

ノ / 

// 通 过 直接 访问 USB 缓冲 区 来 设置 要 处 理 的 字符 

メ / 

ui32ReadIndex = (uint32_t) (pui8Data ~ g_pui8USBRxBuffer) ; 
ui32 WriteIndex = sTxRing. ui32 WriteIndex: 

while( ui32Loop ) 

| 
































// 
// 将 转换 字符 从 接收 缓冲 区 复制 到 发 送 缓冲 区 





ノ / 

// 这 是 一 个 小 写字 符 ? 

LL 

if( (g_pui8USBRxBuffer[ ui32ReadIndex | >= a )&& 
(g_pui8USBRxBuffer| ui32ReadIndex] < + )) 


ん 

// 转 换 为 大 写字 母 并 将 其 写 和 人 到 发 送 缓冲 区 

ノ / 

g_pui8 USBTxBuffer| ui32 WriteIndex ] = 
(g_pui8USBRxBuffer| ui32ReadIndex] 2 a )+ A ; 





else 


// 

// 这 是 一 个 大 写字 符 ? 

ノ / 

if((g_pui8USBRxBuffer| 32ReadIndex | >2 A )&& 
(g_pui8USBRxBuffer| 32ReadIndex |  Z )) 


// 

// 转 换 为 小 写 并 将 其 写 入 到 发 送 缓 冲 区 

// 

g_pui8USBTxBuffer[ ui32WriteIndex | = 
(g_pui8USBRxBuffer| ui32ReadIndex] = Z ) + 2 





// 

// 将 接收 到 的 字符 复制 到 发 送 缓冲 区 

// 

g_pui8USBTxBuffer[ ui32WriteIndex | = 
g_pui8USBRxBuffer| ui32ReadIndex | ; 


// 

// 移 动 到 下 一 个 字符 ,如 果 需 要 ,注意 调整 缓冲 区 的 指针 

// 

ui32 Writelndex ++ ; 

ui32 WriteIndex = (ui32 WriteIndex == BULK_BUFFER_SIZE ) ? 
0: ui32WriteIndex ; 

ui32ReadIndex ++ ; 

ui32ReadIndex = (ui32ReadIndex == BULK_BUFFER_SIZE ) ? 
0: ui32ReadIndex; 








ui32Loop 一 - : 
| 
// 完 成 处 理 准 
ノ / 


Ht 











备 就 绪 的 数据 后 ,立即 将 其 传 回 主机 
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USBBufferDataW ritten( &g_sTxBuffer,ui32Count ) ; 

DEBUG_PRINT(" Wrote %d bytes\n" ,ui32Count ) ; 

KS 

// 为 了 尽 可 能 多 地 处 理 直 接 来 自 接收 缓冲 区 中 的 数据 (需要 返回 的 字 节 数 ) ,允许 下 层 适当 
// 地 更 新 其 读 出 指针 

// 


return( ui32Count ) : 














| 

// ネネ ホネ ポポ ネ ポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ネ ポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネ ポポ ポポ ネネ ポポ ネネ ポポ ネ ポポ ポポ ネ ポポ ポポ ネネ ポポ ネネ 
// 处 理 bulk 驱动 器 通知 相关 的 传输 信道 (数据 到 USB 主机 ) 

ノノ \ 参 数 pvCBData 是 该 通道 客户 端 提 供 的 回调 (callback ) 指針 

/ 八 参 数 ui32Event 确定 要 通知 的 事件 

ノノ \ 参 数 ui32MsgValue 是 特定 事件 的 值 

/ 八 参数 pvMsgData 是 特定 事件 的 指针 

































































ノノ 
// 该 函数 被 bulk 驱动 器 调用 来 通知 与 传输 数据 通道 相关 操作 的 任何 事件 (在 IN 通道 传送 数据 到 
//USB 主机 ) 








ノノ \ retum 返回 值 是 特定 事件 
ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そ そそ: 
uint32_t 
THandler( void * pvyCBData ,uint32_t ui32Event, uint32_t ui32MsgValue, 

void * pvMsgData ) 


// 
// 在 该 例子 中 不 需要 响应 任何 发 送 事 件 , 仅 对 发 送 计数 器 更 新 即 可 
// 

if(ui32Event == USB_EVENT_TX_COMPLETE) 

| 























g_ui32TxCount += ui32MsgValue; 
| 
// 
// 转 存 调试 信息 
// 
DEBUG_PRINT( "TX complete % d\n" ,ui32MsgValue ) ; 
return(0); 





| 

// ネネ ホネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ネネ ボネ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ネネ ポポ ネネ ポポ ポポ ポポ ネネ 
// 处 理 bulk 驱动 器 通知 相关 接收 通道 (数据 来 自 USB 主机 ) 

// 

/ 八 参数 pvCBData 是 该 通道 客户 端 提供 的 回调 指针 

/ 八 参 数 ui32Event 确定 要 通知 的 事件 

//\ 参 数 ui32MsgValue 是 特定 事件 值 

/ 八 参数 pvMsgData 是 特定 事件 的 指针 



























































// 
// 该 函数 被 bulk 驱动 器 调用 来 通知 与 接收 数据 通道 相关 操作 的 任何 事件 (在 OUT 通道 传送 来 自 
//USB 主机 的 数据 ) 

// 


//\ return 返回 值 是 特定 事件 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 





uint32_t 
RxHandler( void * pvCBData ,uint32_t ui32Event, 
uint32_t ui32MsgValue ,void * pyMsgData ) 


ノ // 

// 哪 个 事件 正在 发 送 ? 
Hf 

switch( ui32Event ) 


| 





ノ / 

// 连 接 到 一 个 主机 并 可 能 马上 进行 通信 
ノ / 

case USB_EVENT_CONNECTED: 


| 




















g_bUSBConfigured = true; 
UARTprintf(" Host connected. \n" ) ; 
// 

/7 刷新 缓冲 区 

ノ // 

USBBufferFlush(&g_sTxBuffer) : 
USBBufferFlush(&g_sRxBuffer) : 
break ; 





1 
1 


Xp 

// 断 开 主机 连接 

// 

case USB_EVENT_DISCONNECTED: 

| 
g_bUSBConfigured = false; 
UARTprintf(" Host disconnected. \n" ) ; 
break; 

| 

// 

// 已 经 收 到 一 个 新 的 数据 包 

// 

case USB_EVENT_RX_AVAILABLE.: 

| 
tUSBDBulkDevice * psDevice; 











// 

// 从 回调 数据 参数 获得 一 个 指向 数据 实例 的 指针 
ノ / 

psDevice = (tUSBDBulkDevice * ) pvCBData; 

// 

// 读 取 新 的 数据 包 并 返回 到 主机 

// 


return( EchoNewDataToHost( psDevice, pvMsgData , ui32MsgValue) ) ; 
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// 

// 忽 略 挂 起 和 暂时 恢复 

シグ 2 

case USB_EVENT_SUSPEND: 
case USB_EVENT_RESUME: 

| 

break: 

| 

XY 
// 忽 略 所 有 其 他 事件 并 返回 0 
// 

default: 


| 








break; 


| 


return(0); 


| 


// ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ホネ ポポ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ホネ ポポ ホネ ポポ ホホ ポポ ホホ ポポ ホネ ポポ ポポ ポポ ポポ 
// 配 置 UART 和 引 脚 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ 




















void 

ConfigureUART( void ) 

| 
ROM._ SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOA) ; 
ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 
ROM_GPIOPinConfigure( CPIO_PA0_UORX ) ; 
ROM_GPIOPinConfigure( GPIO_PA1_UOTX ) ; 
ROM_GPIOPinTypeUART(CPIO_PORTA_BASE,GPIO_PIN_0 | GPIO_PIN_1) ; 
UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 
UARTStdioConfig(0 ,115200 ,16000000 ) ; 





! 
} 


// ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ポポ ホホ ポポ ホホ ポポ ポ ホ ポポ ポポ ホホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ 
> FT ゝ 
// 主 应 用 程序 的 入口 函数 


// ホネ ネネ ポポ ポポ ポポ ボネ ポポ ボネ ポ ボボ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ 

















int 
main( void ) 
| 
volatile uint32_t ui32Loop ; 
uint32_t un32TxCount: 
uint32_t ui32RxCount ; 
ROM_FPULazyStackingEnable( ) ; 
ROM_SysCtlClockSet(SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL 16MHZ ) ; 
// 
// 使 能 用 于 开发 板 上 LED 的 GPIO 端口 
// 
ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_CPIOF ) ; 


























// 

// 使 能 用 于 LED 的 GPIO 引 脚 (PF2 和 PF3 ) 

0 

ROM_GPIOPinTypeGPIOOutput( CPIO_PORTF_BASE,GPIO_PIN_3 | GPIO_PIN_2) ; 
// 

// 打 开 UARTO 并 在 UART 上 显示 应 用 程序 的 名 称 

// 

ConfigureUART( ) ; 

UARTprintf(" \033[ 2JTiva C Series USB bulk device example\n" ) ; 

UARTprintf( " \n\n" ) ; 

// 

// 无 需 初始 配置 
2 
g_bUSBConfigured = false: 
























































// 使 能 用 于 USB 的 CPIO 外 设 并 配置 USB 引 肢 





ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_GPIOD) ; 
ROM_GPIOPinTypeUSB Analog( GPIO_PORTD_BASE,GPIO_PIN_4 | GPIO_PIN_5) ; 
// 

// 使 能 系统 时 钟 

// 

ROM_SysTickPeriodSet( ROM_SysCtlClockGet( )/SYSTICKS_PER_SECOND ) : 
ROM_SysTickIntEnable( ) ; 

ROM_SysTickPnable( ) ; 

YN 

// 打 印 USB 配置 

Xp 

UARTprintf(" Configuring USB\n" ) ; 

// 

// 初 始 化 发 送 和 接收 缓冲 区 

ZZ 

USBBufferInit( &g_sTxBuffer) ; 

USBBufferInit( &g_sRxBuffer) ; 

// 

// 设 置 带 VBUS 监视 的 USB 设备 的 堆栈 模式 

// 

USBStackModeSet( 0 ,eUSBModeForceDevice ,0 ) ; 

// 

// 将 设备 信息 传递 到 USB 库 , 并 把 设备 放置 到 总 线 上 
ノ / 

USBDBulkInit(0 ,&g_sBulkDevice ) ; 

// 

// 等 待 初始 配置 完成 

// 

UARTprintf(" Waiting for hosL \n" ) ; 

ノ // 

/清除 计 数 器 中 的 局 部 字 节 
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ノ / 


um32RxCount = 0 ; 
ui32TxCount =0: 





RL 
// 主 要 应 用 程序 循环 
ノ / 
while( 1 ) 
| 
ノ / 
// 查 看 是 否 有 任何 数据 被 传输 
ノ / 
if((u32TxCount ! =g_ui32TxCount) || (ui32RxCount | = g_ui32RxCount) ) 
| 
// 
// 自 从 上 次 检查 之 后 ,有 任何 传输 吗 ? 
ノ / 


if(ui32TxCount | =g_ui32TxCount ) 
| 
// 
// 点 亮 绿 色 LED 
ノ / 
GPIOPinWrite(CPIO_PORTF_BASE ,GPIO_PIN_3 ,GPIO_PIN_3 ) ; 
// 
// 延 迟 
// 
for( ui32Loop =0; ui32Loop < 150000; ui32Loop ++ ) 
| 





// 

// 炸 灭 绿色 LED 

// 

GPIOPinWrite( GPIO_PORTF_BASE ,GPIO_PIN._3 ,0) ; 
// 

//Take a snapshot of the latest transmit count. 

// 最 新 的 发 送 计数 快照 

// 

ui32TxCount = g_ui32TxCount; 


1 
i 





// 
// 自 从 上 次 检查 之 后 ,有 任何 接收 流量 吗 ? // 
if(ui32RxCount ! =g_ui32RxCount) 
| 

// 

// 点 亮 蓝 色 LED // 





GPIOPinWrite( GPIO_PORTF_BASE ,GPIO_PIN_2 ,GPIO_PIN 2); 
ノ / 

// 延 迟 

ノ / 

for( ui32Loop =0; ui32Loop < 150000; ui32Loop ++ ) 


/熄灭 蓝 色 LED 

// 

GPIOPinWrite( GPIO_PORTF_BASE ,GPIO_PIN 2 ,0) ; 
// 

//Take a snapshot of the latest receive count. 

// 最 新 的 接收 计数 快照 

// 

ui32RxCount = g_ui32RxCount; 


| 
// 


// 更 新 传输 字 节 的 显示 
// 
UARTprint( "MrTx. %d Rx: %d" ,ui32TxCount,ui32RxCount) ; 


| 


3. 加 載 sub_dev_bulk 工程 

在 C:uiVTivaWare_C_Series - 2. 0. 1. 11577 \examples \boards\EK - TM4C123CXLNusb_dey 
_bulk 目录 下 加 载 sub_dev_bulk 工程 。 

4. 将 工程 sub_dev_bulk 的 编译 结果 加 载 到 LaunchPad 开发 板 中 

将 工程 sub_dev_bulk 的 编译 结果 加 载 到 LaunchPad 开发 板 中 ， 如 图 14-19 所 示 。 





茵 Debug 里 湾 吃 有 国 | 双人 3 信和 过 | 节日 
2 (Gsb_dev_bulk ode Composer Studio - Device Debugging] 
pp Stellaris In-Circuit Debug Interface_0/CORTEX_M4_0 (Suspended - HW Breakpoint) 
三 main() at usb_dev_bulk.c:484 0x0000026C 
三 _c_int000 at boot.asm:217 0x000026A2 (_c_int00 does not contain frame information) 








= に i 
円 
f 
に 本 
== 


BC 2 = 
il 


PDdM2Un0| /woo mum 





图 14-19 将 编译 结果 导入 到 LaunchPad 开发 板 中 
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5. 测试 
1) 打开 PuTTY ( 波 特 率 为 115200 bit/s) 。 
2) 发 现 新 硬件 (Ceneric Bulk Device) 并 添加 其 驱动 程序 (如 图 14-20 所 示 ) 。 













过 设备 管理 器 





山 更 新 驱动 程序 软件 SGeneriecBulk Device 

文件 (F) 操作 (A) ”查看 VM) 帮助 | Windows 已 经 成 功 地 更 新 驱动 程序 文件 
和 和 中 有 | 画 | 区 

= ou: Windows 已 经 完成 安装 此 设备 的 驱动 程序 软件 : 

4- 議 liuyu-PC ロ ロ 

> 時 DVD/CD-ROM 驱动 器 し 

> 生計 DE ATA/ATAPI 控制 器 

全 9 IEEE 1284.4 兼 容 打 印 机 

IE IEEE 1284.4 设备 山 更 新 驱动 程序 软件 - Generic Bulk Device 

EY Jungo 


` 司 如 Es 浏览 计算 机 上 的 驱动 程序 文件 
a 磁盘 驱动 器 
恒 详 DCoM 和 LPT) | 在 以 下 人 于 搜索 驱动 程序 软件 


十 算 机 
ee TE 


Ee | 设备 





















































































图 14-20 ”发现 新 硬件 (Generic Bulk Device) 并 添加 驱动 程序 过 程 


3) 在 在 C: : \Program Files\Texas Instruments \Stellaris \usb_examples 目录 下 启动 usb_bulk_ex- 
ample bulk 设备 测试 工具 (如 图 14-21 所 示 )。 











| C:NProgram Files\Texas Instruments\Stellaris\usb examples\usb_bu.. llisl 


Stellaris Bulk USB Device Example 


a partner application to the usb_deu_bu1k example 

With Stellarisllare software releases for USB-enabled 
. Strings entered here are sent to the board which 

the case of the characters in the string and returns 

the host. 








string (EXIT to exit): 














图 14-21 usb_bulk_example bulk 设备 测试 工具 

















4) 单 击 工具 栏 中 的 中 图 标 ， 启 动 代码 在 LaunchPad 开发 板 中 运行 ， 测 试 结果 如 图 14-22 

所 示 。 

从 图 14-22 中 可 以 看 到 ,不 但 写 人 到 缓冲 区 中 的 数据 字 节 数 和 从 缓冲 区 中 读 出 的 数据 

字 节 数 相等 ， 而 且 字 母 的 大 小 写 也 发 生 了 倒置 。 并 且 从 上 位 机 “usb_bulk_example” 得 出 的 

测试 结果 和 通过 UART 读 出 的 测试 结果 一 致 ， 验 证 了 上 述 程序 实现 了 所 要 求 的 功能 ， 程 序 设 
计 正 确 。 






























































298 


中 | C:\Program Files\Texas Instruments\Stellaris\usb_examples\usb_bulk_example.exe 


Ste11aris Bu1k USB Device Example 


a partner application to the usb_deu_bulk example 
| 
Strings entered here are sent to the board which 


the case of the characters in the string and returns 
the host. 


string (EXIT to exit):(I am sending! 


Wrote 14 butes to the device.AExpected © “ 


Read 14 bytes from deuice. Expected (14 
Returned string: ("i AM SENDINGY 


Enter a string (EXIT to exit): 





图 14-22 对 bulk 设备 的 测试 结 且 


"i 
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oo 第 うき の の 


FatFS 文件 读 取 实验 


本 章 以 TI 提供 的 基于 安全 数码 卡 (Secure Digital Memory Card) 的 FatFS 文件 读 取 实验 为 
例 来 介绍 其 使 用 方法 ， 可 使 不 熟悉 SD 卡 ( 即 安全 数码 卡 ) 协议 的 读者 能 读 懂 SD 卡 的 驱动 程 
序 。 本 章 先 简要 介绍 SD 卡 2.0 的 基本 知识 (这 部 分 内 容 来 自 于 SD 卡 2.0 协议 和 网 络 ) ， 然 后 
说 明 TI 提供 的 SD 卡 驱动 程序 的 编写 方法 ， 最 后 演示 基于 SD 卡 的 FatFS 文件 系统 的 读 取 过 程 。 


本 章 的 主要 内 容 : 


> SD 卡 介 绍 
> FatFS 文件 系统 简介 
> 基于 SD 卡 的 文件 读 取 实验 




















下 面 仅 就 比较 常用 的 几 种 存储 卡 作 一 简单 介绍 : 

MMC (MultiMedia Card) 多 媒体 卡 是 一 种 非 易 失 性 存储 器 件 ，1997 年 由 西门 子 及 
SanDisk 公司 共同 开发 。SD 卡 是 在 MMC 的 基础 上 发 展 而 来 的 ， 由 日 本 松下 、 东 芝 及 SanDisk 
公司 于 1999 年 共同 开发 研制 ， 它 是 基于 半导体 Flash 的 新 一 代 记 忆 设 备 ， 仅 一 张 邮 票 大 小 





(如 图 15-1 所 示 ) 。 目前 有 3 个 版 本 的 SD 卡 协议 ，SD 卡 2.0 版 本 Samisk 

根据 容量 的 大 小 ， 可 分 为 SDSC 卡 ( 即 SD 卡 ) (容量 <2GB) 和 
SDHC (2 GB < 容量 <32 GB) ， 且 向 前 兼容 SD 卡 1.0 版 和 MMC 卡 ， 
即 所 有 支 持 SD 卡 的 设备 也 支持 WMC 卡 。 回 153-1 migSD 本 外形 


SD 卡 的 内 部 结构 及 信号 描述 

1. SD 卡 的 内 部 结构 

SD 卡 的 内 部 结构 如 图 15-2 所 示 。 

2. SD 卡 的 寄存 器 描述 

在 图 15-2 中 SD 卡 的 左 侧 的 寄存 器 描述 见 表 15-1。 

3. SD 卡 的 引 脚 信号 描述 

SD 卡 支持 两 工作 模式 ， 即 SD 模式 (独立 指令 和 数据 通道 ， 独 有 的 传输 格式 ) 和 SPI 
模式 (独立 序列 输入 和 序列 输出 )。 在 基于 ARM Cortex 器 件 的 应 用 中 ， 一 般 采 用 SPI 模式 。 
SD 卡 的 引 脚 描述 见 表 15-2; 实物 图 如 图 15-3 所 示 。 
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DAT2 CMD — CLK 
CD/DAT3 内 部 驱动 





图 15-2 SD 卡 的 内 部 结构 
表 15-1 SD 卡 的 寄存 器 描述 









































































































































名 称 宽度 /bit 描述 
CID 128 用 于 识别 SD 卡 的 卡 识别 号 (強制 ) 
RA ee SD 卡 的 相对 地 址 (在 SPI 模式 不 可 用 ) 。 卡 的 本 地 动态 地 址 ， 可 在 卡 的 主机 初始 化 过 程 中 确 
认 (强制 ) 
DSR 16 驱动 阶段 寄存 器 ， 用 于 配置 SD 卡 的 输出 驱动 器 (可 选 ) 
CSD 128 SD 卡特 性 数据 ， 有 关卡 的 操作 条 件 信 息 (強制 ) 
SDR 64 SD 卡 配置 寄存 器 ， 有 关 microSD 存储 卡 的 特殊 功能 的 信息 (强制 ) 
OCR 32 操作 条 件 寄存 器 (強制 ) 
表 15-2 SD 卡 的 引 脚 描述 
SD 模式 SPI 模式 
名 称 类 型 描述 名 称 类 型 描述 
1 CD/DAT3 1/0/PP 卡 检测 /数据 线 3 CS I 片 选 ( 低 有 效 ) 
2 CMD PP 命令 /回复 DI I 数据 输入 
3 Vssl S 地 VSS S 地 
4 Vdd S 供电 电压 VDD S 供电 电压 
5 CLK 1 时 钟 CLK 1 时 钟 
6 Css2 S 地 VSS2 S 地 
7 DATO 0/PP 数据 线 0 DO 0 数据 输出 
8 DATI1 0/PP 数据 线 1 RSV 一 
9 DAT2 0/PP 数据 线 2 RSV 一 
注 . 5 为 电源 供电 ，I 为 输入 ，0 为 输出 ，LOZPP 为 使 用 推 挽 驱动 的 输入 输出 。 
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[8|DAII| | 
[7 [DATO| Do | 


SD 卡 的 命令 


1. SD 卡 的 命令 格式 
SD 卡 的 命令 格式 见 表 15-3。 


| 《 
t 





microSD 


表 15-3 SD 卡 的 命令 格式 


字 节 2 ~5 (参数 命令 ) 








CMD 


例如 CMD0 命令 格式 为 


高 位 在 前 〈 参 数 可 以 为 空 ) 


01 000000 0000…00 10010101 
固定 命令 参 数 CRC 码 
0x40 0x00… 0x00 0x95 


2. SD 卡 的 命令 


SD 卡 的 命令 


可 共 分 为 12 类 ， 即 Class0 ~ Class11， 其 中 部 分 命令 集 见 表 15-4。 


表 15-4 SD 卡 命令 分 类 及 功能 




































































卡 识别 、 初 始 化 等 基本 命令 集 : Class0 
命令 | 响应 缩写 功 能 
CMDO | RI GO_IDLE_STATE 复位 SD 卡 
CMD1 | RI SEND_OP_COND 激活 卡 的 初始 化 过 程 〈 读 OCR 寄存 器 ) 
CMD8 | R7 SEND_IF_COND 检查 SD 卡 工作 电压 范围 
CMD9 | RI SEND_CSD 读 CSD 寄存 器 
CMD10 | RI SEND_CID 读 CID 寄存 器 
CMD12 | RI STOP_TRANSMISSION 禁止 读 多 块 时 的 数据 传输 
CMD13 | R2 SEND_STATUS 读 卡 状态 寄存 器 
ACMD41| RI SEND_OP_COND 发 送 主 机 容量 支持 信息 ， 并 激活 该 卡 的 初始 化 过 程 
CMD58 | R3 READ_OCR 接 到 本 指令 后 ， 卡 将 传送 OCR 数据 
CMD59 | RI CRC_ON_OFF 设置 CRC 使 能 (1) 或 禁止 (0) 











读 卡 命令 集 : Class2 

















命令 | 响应 缩写 功 能 
CMD16 | RI SET_BLOCK_LEN 设置 块 的 长 度 

CMD17 | RI READ_SINGLE_BLOCK 读 单 块 

CMD18 | RI READ_MULTIPLE_BLOCK 读 多 块 , 直到 主机 发 送 CMD12 为 止 
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( 续 ) 









































































































































命令 | 响应 缩写 功 能 

CMD24 | RI WRITE_BLOCK 写 单 块 

CMD25 | RI WRITE_MULTIPLE_BLOCK 写 多 块 

CMD27 | RI PROGRAM_CSD 写 CSD 寄存 器 

探 除 卡 命令 集 : Class5 

命令 | 响应 缩写 功 能 

CMD32 | RI ERASE_WR_BLK_START 设置 块 擦 除 的 起 始 地 址 

CMD33 | RI ERASE_WR_BLK_END 设置 块 擦 除 的 终止 地 址 

CMD38 | Rlb ERASE 选择 要 擦 除 的 块 

写 保护 命令 集 : Class6 

命令 | 响应 缩写 功 能 

CMD28 | Rlb SET_WRITE_PROT 设置 块 写 保护 的 地 址 

CMD29 | Rlb CLR_WRITE_PROT 探 除 块 写 保护 的 地 址 

CMD30 | RI SEND_WRITE_PROT 查询 卡 写 保护 位 的 状态 

SD 卡 锁定 ， 锁 解除 功能 命令 集 : Class7 

申请 特定 命令 集 : Class8 

命令 | 响应 缩写 功 能 

CMD55 | RI | APP-CMD〈 所 有 应 用 命令 之 前 必须 | 。 告知 卡 的 下 一 条 命令 旦 特殊 命令 ， 而 非 标准 命令 
先 执行 CMD55 ) 

CMD56 | RI GEN_CMD 应 用 相关 (通用 目的 ) 的 数据 块 读 写 命令 














Class10 、11: 保留 


3. 命令 响应 格式 

1) R1: 每 一 个 命令 之 后 由 卡 发 送 该 响应 令 牌 ( 除 SEND_STATUS 命令 外 ) ， 其 长 度 为 1 
个 字 节 ， 最 高 有 效 位 ( Most Significant Bit, MSB ) 总 是 设置 为 零 ， 其 他 位 为 错误 指示 。R1 
的 响应 格式 如 图 15-4 所 示 。 





7 6 5 4 3 0 
| 0 | 参数 错误 | 地 址 错误 | 棕 除 顺序 错误 
图 15-4 RI 响应 格式 


2) R2: 由 卡 发 送 的 响应 SEND_STATUS 命令 的 响应 令 牌 (长 度 为 2B) , R2 的 响应 格式 
如 图 15-5 所 示 。 


ーー rr CC 错误 | 错误 | 跳 过 写 保护 擦 除 ， 锁 | 卡 锁定 
定 / 解 锁 命令 失败 








EN CT OS I 
图 15-5”R2 响应 格式 
3) R3: 当 收 到 READ_OCR 命令 时 ， 由 卡 发 送 的 反应 令 牌 ， 响 应 长 度 为 SB。 第 1 
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(MSB) 字 节 的 结构 与 响应 类 型 R1 相同 ， 其 他 4B 包含 OCR 寄存 器 ， 如 图 15-6 所 示 。 


39 3231 


0 
刘 E | 


-一 -一 一 


RI OCR 
图 1$-6 R3 的 响应 格式 
SD 卡 的 功能 描述 
主机 和 卡 之 间 的 所 有 通信 都 是 由 主机 控制 的 ， 主 机 所 发 送 的 命令 包括 广播 和 寻 址 (点 
对 点 ) 命令 两 种 通信 类 型 。 

SD 卡 的 操作 可 分 为 两 种 模式 : 卡 识别 模式 ; 数据 传输 模式 。 
表 15-$ 表达 了 卡 状态 与 操作 模式 之 间 的 关系 。 

表 15-5 卡 状态 与 操作 模式 



































卡 状态 操作 模式 
非 激活 状态 元 动作 
空闲 状态 
就 绪 状 态 卡 识别 模式 
识别 状态 
待机 状态 
传输 状态 
发 送 数据 状态 ーー 


1. 卡 识别 模式 

在 该 模式 下 ， 主 机 将 检测 SD 卡 的 电压 范围 ， 识 别 SD 卡 类 型 ， 并 要 求 其 发 送 各 自 的 相 
对 地 址 ， 这 一 切 操作 都 是 通过 命令 线 (CMD 线 ) 来 实现 的 ， 所 有 操作 均 采 用 默认 的 SD 卡 
识别 时 钟 频 率 。 

(1) 卡 复位 

当 卡 上 电 或 收 到 GO_IDLE_STATE( CMD0) 命 令 之 后 ，SD 卡 都 将 进入 空闲 状态 〈 非 激活 
的 卡 除外 ) 。 即 卡 上 电 至 少 延迟 74 个 时 钟 周期 后 方 可 进行 总 线 传输 (发 送 复位 命令 CMD0)， 
竺 复位 完成 后 〈 即 接收 到 01h 响应 ， 如 图 15-12 所 示 )， 在 得 到 响应 0x00 前 需 连 续 发 送 
CMD55 + ACMD41。 当 处 于 空闲 状态 时 ，SD 卡 的 CMD 线 处 于 输入 模式 ， 等 待 下 一 个 命令 的 
起 始 令 牌 。 默 认 的 相对 地 址 RCA 为 Ox0000。 

(2) 工作 条 件 验 证 

① 在 主机 和 SD 卡通 信之 前 ， 主 机 并 不 知道 SD 卡 支持 的 电压 范围 ， 这 时 主机 先 用 一 个 
特定 的 电压 发 送 一 条 复位 命令 (CMDO ) ， 然 后 发 送 SEND_IF_COND (CMD8) 命令 来 获取 SD 
卡 所 支持 的 电压 范围 。 如 果 SD 卡 不 支持 所 提供 的 电压 ， 则 不 会 发 出 任何 响应 信息 ，SD 卡 
将 继续 处 于 空闲 状态 。 
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② 在 空闲 (Idle) 模式 下 , SD_SEND_OP_COND( ACMD41 ) 命 令 旨 在 提供 一 种 SD 卡 主 
机 识别 并 拒绝 与 主机 给 定 电 压 VDD 不 匹配 卡 的 机 制 。 主 机 通过 发 送 命令 操作 数 来 作为 所 需 
电压 VDD 窗口 的 大 小 。 若 SD 卡 在 指定 范围 内 不 能 进行 数据 传输 ， 应 放弃 进一步 的 总 线 操 
作 ， 而 进入 非 激 活 状态 。 注 意 : A 开头 的 命令 可 看 作 “Application Command” 的 伴随 命令 ， 
在 发 任何 一 条 ACMD 命令 之 前 ， 必 须 首先 发 一 条 CMD55 命令 ， 因 此 在 发 送 ACMD41 命令 
时 ， 必 须 先 行 发 送 CMDSS 命令 ， 然 后 方 可 发 送 ACMD41 命令 。 

③ 在 准备 “就 绪 ” 模 式 下 ， 主 机 将 发 送 ALL_SEND_CID(CMD2 ) 命令 到 每 个 卡 中 来 获 
取 它 们 的 唯一 卡 标识 号 (CID ) 。 当 卡 发 送 完 CID 号 后 ，SD 卡 将 进入 识别 状态 。 

④ 当主 机 发 送 SEND_RELATIVE_ADDR( CMD3 ) 命令 来 要 求 各 个 SD 卡 发 送 一 个 新 的 相 
对 地 址 (RCA) 时 ，RCA 用 于 其 后 在 数据 传输 模式 中 的 卡 寻 址 。 一 旦 获取 RCA， 卡 状态 将 
变 成 待机 状态 。 此 时 ， 如 果 主 机 想 要 给 SD 卡 分 配 一 个 新 的 RCA ， 只 需 发 送 另 一 条 CMD3 命 
令 给 SD 卡 即 可 ， 最 后 发 布 的 RCA 就 是 实际 使 用 的 RCA 了 。 这 个 唯一 地 址 发 送 给 主机 就 进 
入 了 下 一 个 阶段 的 数据 传输 模式 ， 每 张 SD 卡 将 与 主机 进行 点 对 点 的 传输 。 

注意 : 当主 机 发 出 CMDO 命令 来 复位 SD 卡 时 ， 应 先 发 出 CMD8 命令 再 发 送 ACMD41 命 
令 来 重新 初始 化 SD 卡 。 

SD 卡 的 状态 图 ( 卡 识别 模式 ) 如 图 15-7 所 示 ; 而 SD 卡 的 初始 化 与 识别 流程 (SD 模 
式 ) 如 图 15-8 所 示 。 
































除非 激活 外 的 所 有 状态 


如 果 卡 不 能 在 供电 电压 下 操作 ， 
卡 将 不 响应 并 返回 到 “空闲 状态 ” 


















































卡 返 回 忙 或 主机 忽略 电压 范 强制 主机 兼容 2.00 版 物理 规范 ， 


在 ACMD41 之 前 ， 先 发 送 CMD8 
Er 
































无 响应 ( 非 有 效 的 命令 ) 
必然 是 MMC 卡 










不 兼容 电压 范围 的 卡 











在 CMD1 开 始 多 媒 
体 卡 的 初始 化 过 程 








识别 状态 


数据 传输 模式 从 数据 传输 模式 中 的 所 有 状 
卡 响应 新 的 RCA 


图 15-7 SD 卡 的 状态 图 ( 卡 识别 模式 ) 


卡 识别 模式 卡 响应 新 的 RCA 











2. 数据 传输 模式 
在 SD 卡 识别 模式 结束 之 后 ， 主 机 先 不 停 地 发 送 SEND_CSD (CMD9 ) 命令 来 获取 卡 的 
CSD 信息 ， 包 括 块 长 度 、 卡 容量 等 。 广 播 命令 SET_DSR(CMD4 ) 为 各 个 已 识别 的 SD 卡 配置 
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CMD0 
无 响应 卡 返 回响 应 
2.00 或 更 高 版 本 电压 不 匹配 的 SD 卡 ， 2.00 版 或 更 高 版 本 SD 卡 ) 不 兼容 的 电压 范围 


ny 








或 Verl.X SD 卡 或 无 SD 卡 


HCS=0 


Y 二 压 范 转 
卡 的 兼容 电压 范围 ) 并且 检查 模式 正 确 


a 卡 就 绪 了 吗 ? 如 果 主 机 支持 高 容 
ACMD41 量 ，HCS 应 设置 为 1 


不 兼容 的 电压 范围 〈 卡 进入 | |Y 
非 激活 状态 ) 或 超时 发 生 卡 返 回 忙 


(没有 应 答 或 忙 ) 
卡 就 绪 了 吗 ? 不 可 用 卡 
卡 返回 就 结 一 了 Y SN 


无 响应 













































卡 返回 就 绪 CCS=1 
| CCS=0 
Verl.x 标 准 容量 2.00 或 更 高 版 本 2.00 或 更 高 版 本 
SD 标准 容量 SD 卡 大 容量 SD 卡 


图 15-8 SD 卡 的 初始 化 与 识别 流程 (SD 模式 ) 





驱动 阶段 。 它 会 向 SD 卡 的 DSR 寄存 器 写 和 人 相关 的 信息 ， 包 括 数 据 总 线 宽度 、 总 线 上 卡 的 
个 数 、 总 线 频 率 等 ， 这 里 SET_DSR 命令 是 可 选 的 。 

CMD7 命令 可 使 指定 地 址 的 SD 卡 进 入 传输 模式 ， 在 指定 时 间 段 内 ， 只 有 一 个 卡 能 处 于 
传输 状态 。 当 某 个 原先 被 选中 的 处 于 传输 状态 的 SD 卡 接收 到 CMD7 命令 后 ， 会 释放 与 主机 
的 连接 ， 并 进入 待机 状态 。 当 CMD7 使 用 保留 地 址 0x0000 时 ， 所 有 的 SD 卡 都 将 进入 待机 
状态 。CMD13 用 于 得 到 卡 的 CSD 的 相关 设置 值 ，ACMD6 用 于 配置 数据 总 线 的 宽度 ; 读 操 作 
使用 CMD17 、 CMD18 、 CMD30 、CMD56(r) 、ACMD13 、ACMD22 、 ACMD51 命令 ; 写 操作 使 
用 CMD24 、 CMD25 CMD26 、CMD27 、CMD42 、CMD56(w) 命令 ; 读 / 写 停止 操作 使 用 CMD12 
命令 。 有 关 SD 卡 数据 传输 模式 更 多 的 信息 如 图 15-9 所 示 。 

3. SD 卡 的 读 写 操作 

(1) SD 卡 的 数据 读 取 

在 SPI 模式 下 ， 读 命 令 支 持 单 块 (CMD17) 和 多 个 块 (CMD18 ) 的 读 操作 。 由 命令 
CMD16 设 定 块 的 长 度 为 512 B。 块 数据 读 取 操 作 如 图 15-10 所 示 ; 读 取 单 块 数据 流程 如 
图 15-11 所 示 。 
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卡 的 识别 模式 


从 数据 传输 模式 下 的 所 有 状态 



















数据 传输 模式 





CMD17, 18, 30 








CMD24, 25, 26, 
27, 42, 56 (W) 


接收 数据 状态 


CMD12 或 
传输 结束 














图 15-9 数据 传输 模式 的 SD 卡 状 态 图 


















| 数据 块 CRC| 三 十 数据 块 JCRC] 1 数据 块 [CRC 





ーーーー 单 块 读 取 操 作 - -~ - 
------------- 多 块 读 取 操作 ----------- 


图 15-10 ( 多 ) 块 数据 读 取 操 作 





(2) SD 卡 的 数据 写 和 人 

在 SPI 模式 下 ， 写 数据 块 命令 将 把 单 块 (CMD24 ) 或 多 
块 (CMD27) 数 据 写 人 SD 卡 中 ， 支持 块 写 入 操作 的 SD 卡 
要 求 由 命令 CMD16 来 设置 块 的 长 度 为 512B。 若 出 现 BLOCK 
_LEN_ERROR 或 ADDRESS_ERROR， 写 命令 将 被 禁止 。 块 
数据 写 入 操作 如 图 15-12 所 示 ; 写 入 单 块 数据 的 流程 如 
图 15-13 所 示 。 

注意 : 在 进行 SD 卡 的 数据 写 操作 时 ， 最 好 首先 对 该 卡 
进行 擦 除 操作 ， 然 后 再 做 写 数 据 操作 。 

(3) SD 卡 的 数据 擦 除 

在 SPI 模式 下 ， 首 先 发 送 CMD32 命 信 和 参 数 来 指定 要 擦 
除 的 起 始 地 址 〈 即 块 号 ) ， 然 后 再 发 送 CMD33 命令 来 指定 结 
束 地 址 ， 最 后 发 送 CMD38 命令 来 擦 除 指定 单元 的 数据 ， 注 
意 这 3 个 操作 步 又 不 可 更 改 。 





图 15-11 






, 56 て ) 


ACMD13, 22, 51 


传输 状态 CMD17.32.33 


ACMD6.42 
ACMD23 





接收 起 始 令 牌 0XFE 


接收 512 字 节 数 据 


接收 2 字 节 的 CRC 码 
8 个 CLK 后 停止 数据 传输 






人 停止 命令 

了 据 从 卡 到 主机 

EN TRNASR 停止 数据 传输 
を pe A A 





- 数据 停止 操作 - - 

























读 取 单 块 数据 流程 
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从 卡 
到 主机 
响应 “上 == 才 =- 一 二 = 一 一 一 一 
000 [Rd- 
---- 单 块 写 和 操作------------- 如 
Ry 后 停止 数据 传输 
图 15-12 ( 多 ) 块 数据 写 入 操作 較 15-13 写 入 单 块 数据 流程 


SD 卡 驱动 程序 解读 


由 于 SD 协议 内 容 比 较 宽泛 ， 如 果 对 它 没 有 较 深 刻 的 理解 ， 想 要 写 出 SD 卡 的 驱动 程序 
也 不 是 件 容易 的 事 。 或 许 从 芯片 厂家 提供 的 SD 卡 驱 动 程序 人 手 ， 不失为 一 种 多 快 好 省 的 方 
法 。 下 面 将 根据 以 上 介绍 的 SD 卡 知 识 ， 对 TI 提供 的 SD 卡 驱动 程序 作 一 说 明 。 














/* */ 
/* 这 段 程 序 是 对 FatFS 网 站 的 样本 进行 修改 得 来 的 */ 
/* */ 





#include < stdint. h > 





#include "fatfs/sre/diskio. h" 









































/* 定 叉 MMC/SDC 命令 */ 

#define CMDO (0x40 + 0) /# 复 位 SD 本 。 */ 

#define CMD1 (0x40 +1) /* 读 OCR 寄存 器 */ 

#define CMDS (0x40 +8) /*SEND_IF_COND */ 

#define CMD9 (0x40 +9) /* 读 CSD 寄存 器 */ 

#define CMD10 (0x40 + 10) /* 读 CID 寄存 器 */ 

#define CMD12 (0x40+12) ”/* 禁 止 读 多 块 时 的 数据 传输 */ 

#define CMD16 (0x40+16) ”/* 设 置 块 的 长 度 */ 

#define CMD17 (0x40+17) ”/* 读 单 块 */ 

#define CMD18 (0x40+18) ”/* 读 多 块 ,直到 主机 发 送 CMD12 为 止 */ 
#define CMD23 (0x40+23) ”/#* 设 置 块 数 日 */ 

#define CMD24 (0x40+24) ”/# 写 单 块 */ 

#define CMD25 (0x40 +25) /+#* 写 多 块 */ 

#define CMD41 (0x40+41) ”/* 引 用 命令 的 前 命令 */ 

#define CMD55 (0x40+55) ”/* 所 有 应 用 命令 之 前 必须 先 执行 CMD55 */ 
#define CMDS8 (0x40+58) ”/* 接 到 本 指令 后 , 卡 将 传送 OCR 数据 */ 





/* 。 DK-TM4C123G 板 的 SSI 端口 定义 */ 
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#define SDC_SSI_BASE SSIO_BASE 
#define SDC_SSI_SYSCTL_PERIPH SYSCTL_PERIPH_SSIO 
// 用 于 SSI 的 CPIO 引 脚 


#define SDC_GPIO_PORT_BASE GPIO_PORTA_BASE 

#define SDC_GPIO_SYSCTL_PERIPH SYSCTL_PERIPH_GPIOA 

#define SDC_SSI_CLK GPIO_PIN_2 

#define SDC_SSI_TX GPIO_PIN_5 

#define SDC_SSI_RX GPIO_PIN_4 

#define SDC_SSI_FSS GPIO_PIN_3 

#define SDC_SSI_PIN (SDC_SSI_TX | SDC_SSI_RX | SDC_SSI_CLK | SDC_SSI_FSS ) 


// 使 卡 的 CS 引 脚 有 效 , 即 CS =0 拉 低 
static 
void SELECT ( void ) 
| 
ROM_GPIOPinWrite( SDC_GPIO_PORT_BASE,SDC_SSI_FSS,0 ) : 
| 
// 使 卡 的 CS 引 脚 无 效 , 即 CS =1 拉 高 
static 


void DESELECT ( void ) 


ROM_GPIOPinWrite(SDC_CPIO_PORT_BASE,SDC_SSI_FSS,SDC_SSI_FSS) ; 












































/* 
模 据 的 私 有 豆 数 
*/ 

static volatile 
DSTATUS Stat = STA_NOINIT; /* 卡 状态 */ 
static volatile 
BYTE Timerl ,Timer2 ; /* 100 Hz 递减 定时 器 */ 
static 
BYTE CardType /*b0:MMC,b1 :SDC,b2: 块 寻 址 * 7 
static 
BYTE PowerFlag =0: /* 电源 接 通 指示 */ 
/* */ 
/* 通过 SPI 发 送 一 个 字 节 到 MMC 卡 (与 平台 相关 ) */ 
/* */ 
static 
void xmit_spi( BYTE dat) 
| 

uint32_ t ui32RcvDat ; 

ROM_SSIDataPut( SDC_SSI_BASE,dat) ; /* 向 发 送 FIFO 中 写 入 数据 * / 

ROM_SSIDataCet( SDC_SSI_BASE,&ui32RcvDat) ; /*# 在 写 人 过 程 中 刷新 读 取 数据 * / 
| 
ノ * */ 
/* 通过 SPI 从 MMC 卡 接收 一 个 字 节 (与 平台 相关 ) */ 
/* */ 





static 
BYTE revr_spi (void ) 
| 
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uint32_t ui32RevDat; 

ROM_SSIDataPut( SDC_SSI_BASE,OxFT ) ; 
ROM_SSIDataCet(SDC_SSI_BASE , &ui32 RevDat) ; 
return ( BYTE ) ui32RevDat; 


1 
) 


static 
void rcvr_spi_m ( BYTE *dst) 
| 

* dst = revr_spi( ) ; 


1 
i 


/* 在 写 数据 块 前 需 写 人 若干 空 数据 */ 
/* 从 接收 FIFO 读 取 数据 * / 











/ * */ 
/* 等 待 卡 准备 就 绪 * ノ 
/ * */ 
static 
BYTE wait_ready (void) 
| 

BYTE res; 

Timer2 = 50; /* 等 待 准备 就 绪 ,500ms 超时 * /7 

revr_spi( ) ; 

do 

res = revr_spi( ) ; 

while ((res | =OxFF) && Timer2 ) ; 

return res; 
| 
/* */ 




















/* 发 送 80 个 左右 的 时 钟 脉冲 给 CS 信号 并 使 DI(IN) 为 高 电 平 。 这 是 对 卡 上 电 后 进入 SPI 模式 的 





要 求 ,如 图 15-14 所 示 */ 


CLK 74+clocks 8 














CS La i | 
| 1 | | 
1 ht 1 
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40h 
(CMD0) 


9Sh 1 
(CRC) ! 


(数 据 )OUT ET 


olh 


图 15-14 SD 卡 复位 的 时 序 图 


*/ 





/* 
static 
void send_initial_clock_train( void ) 


| 


UINT i; 
uint32_t ui32Dat; 
/* 确保 CS 保持 高 电 平 */ 


DESELECT( ) ; 
/+* 将 SSI TX 线 切换 到 GPIO 并 使 其 为 高 




















B ギ ォ ノ 


ROM_GPIOPinTypeCPIOOutput(SDC_CPIO_PORT_BASE,SDC_SSI_TX ) ; 


| 


ROM_CPIOPinWrite(SDC_CPIO_PORT_BASE,SDC_SSI_TX ,SDC_SSI_TX ) ; 
/* SSI 发 送 10 个 字 节 空 操作 来 使 SD 卡 达 到 正常 工作 电压 和 进行 同步 * 
for(i=0 ;i<10 ;i++) 


| 

















/* 写 空 数据 。 直 到 FIFO 中 有 多 余 空间 * / 
ROM_SSIDataPut( SDC_SSI_BASE,OxFF) ; 
/* 数 据 写 人 过 程 中 刷新 读 取 数据 */ 
ROM_SSIDataCet( SDC_SSI_BASE,&ui32Dat) ; 
| 
/* 返 回 SSI TX 线 的 硬件 控制 */ 
ROM_GPIOPinTypeSSI( SDC_GPIO_PORT_BASE,SDC_SSI_TX) ; 











/* */ 
/* 电源 控制 (与 平台 相关 ) */ 
/* */ 





/* 当日 标 系 统 不 支持 电源 插 横 控制 时 ,这 些 函 数 将 无 动作 并 且 chk_power 总 是 返回 1 */ 


static 











void power_on (void) 


| 


| 


/* 这 并 不 要 真正 打开 电源 ,而 只 是 初始 化 与 卡 会 话 的 SSI 端口 和 引 脚 * / 

/* 使 能 用 于 驱动 SDC 卡 的 SSI 外 设 */ 

ROM_SysCtlPeripheralEnable( SDC_SSI_SYSCTL_PERIPH); 

ROM._ SysCtlPeripheralEnable( SDC_GPIO_SYSCTL_PERIPH ) ; 

/* 将 GPIO 引 脚 配置 成 SSI 功能 */ 

ROM_GPIOPinTypeSSI( SDC_GPIO_PORT_BASE,SDC_SSI_TX | SDC_SSI_RX | SDC_SSI_CLK ) ; 
ROM_CPIOPinTypeCPIOOutput(SDC_GPIO_PORT_BASE,SDC_SSI_FSS) ; 

/* 設 連 SSI 输出 引 脚 为 4mA 推 挽 驱动 并 上 拉 到 接收 线 上 */ 

ROM_GPIOPadConfigSet( SDC_GPIO_PORT_BASE,SDC_SSI_RX, CPIO_STRENGTH_4MA, 
GPIO_PIN_TYPE_STD_WPU ) ; 

ROM_CPIOPadConfigSet( SDC_GPIO_PORT_BASE,SDC_SSI_CLK | SDC_SSI_TX | SDC_SSI_FSS, 
GPIO_STRENGTH_4MA,GPIO_PIN_TYPE_STD ) ; 












































/* 配置 SSIO 端口 */ 

ROM_SSIConfigSetExpClk ( SDC_SSI_BASE, ROM_SysCtlClockGet( ) , 

SSI_ FRF_MOTO_MODE 0,SSI MODE_MASTER,400000,8) : 
ROM_SSIEnable( SDC_SSI_BASE) ; 

/*# 设置 DI 和 CS Nn 为 使 SD 卡 正常 工作 至 少 延迟 74 个 SCLK 脉冲 (如 图 15-14 所 示 ) */ 
/* 接收 本 地 命令 


NM ) ; 



































PowerFlag =1: 





// 设 置 SSI 速度 到 最 大 


static 




















void set_max_speed( void ) 


| 


unt32_ti; 

/* 共 団 SSI */ 

ROM_SSIDisable( SDC_SSI_BASE) , 

/* 设置 最 大 时 钟 频率 为 系统 时 钟 的 一 半 , 即 12.5 MHz */ 
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i=ROM_SysClClockCet( )/2; 
if(i > 12500000) 
| 

i = 12500000; 
| 
/* 配置 SSIO 端口 以 12.5 MHz 运行 * ノ 
ROM_SSIConfigSetExpClk(SDC_SSL BASE,ROM_SysCtlClockGet( ) , 

SSI_ FRF_MOTO_MODE_0,SSI_ MODE_MASTER,i,8) ; 























/* 使 能 SST */ 
ROM_SSIEnable( SDC_SSI_BASE) ; 
| 
static 
void power_off (void ) 
| 


PowerFlag =0: 
| 
static 


int chk_power( void ) /* 插 权 的 电源 状态 :0 = 关 ,1 = 开 */ 
| 





return PowerFlag; 


| 





/ * */ 
/* MMC 接收 数据 包 , 如 图 15-15 所 示 ( 包 括 参 考 图 15-10、 图 15-11) 
CIK 88X48 8X 8 8X4 8 8X2 8 
CS 1 1 Na; INAc 1 1 
1 1 1 1 1 1 
1 1 1 1 1 1 
HN MSH 
Ly | 512B 1 
S1h CE 1 1 1 1 
2 
00h 人 1 


数据 起 始 令 牌 FEh 2 个 伪 CRC 码 
图 15-15 SD 卡 读 操作 时 序 











/ * */ 
static 
BOOL revr_datablock ( 
BYTE * buff， /* 保存 接收 数据 的 数据 缓冲 区 * / 
UINT br /* 字 节 数 (必须 是 偶数 ) */ 
) 


BYTE token: 
Timerl = 100: 
do | /* 等 待 数 据 包 的 100ms 超时 (SD 卡 协议 要 求 ) */ 

token =rcvr_spi( ) ; 


| while ( (token ==OxFF) && Timerl ) : /* 如 图 15-15 中 SD 卡 读 操 作 时 序 * / 

















if(token | =OxFE ) return FALSE: /* 如 果 不 是 数据 起 始 令 牌 ,将 返回 错误 */ 
do | /* 将 收 到 的 数据 块 存 人 缓冲 区 中 */ 





revr_spi_m( buff ++ ) ; 


了 72 


revr_spi_m( buff ++ ) ; 
| while (btr - =2): 


rcvr_spi( ) ; /* 丢弃 读 取 的 两 个 字 节 的 CRC 偽 */ 
revr_spi( ); 
return TRUE: /* 返 回 成功 */ 
| 
/* */ 











/* 发 送 一 个 数据 包 到 MMC 卡 中 ,如 图 15-16 所 示 ( 包 括 图 15-12、 图 15-13 ) 


CLK 8 8X4 8 8X 8 8X 8 512+2 8 8X 8 


CS 一 1 (ee i 1 
1 nat I 1 


1 | | 512B | 


1 1 

hm 一 「 ) 薄 呈 
1 
1 





58h FFh | FE CRC 
(CRC) 1 (起 始 令 牌 ) (2 个 伪 CRC 码 ) 
(数据 )OUT 
00h 全 
XXX00101b 
图 15-16 SD 写 人 操作 时 序 
/ * */ 
#if _READONLY ==0 
static 
BOOL xmit_datablock ( 
const BYTE * buff, /* 要 发 送 512 字 节 的 数据 块 , 见 图 15-16 */ 
BYTE token /* 数据 /停止 令 牌 */ 
) 


BYTE resp, we; 
if (wait_ready( ) ! =OxFF ) return FALSE: 





xmit_spi( token ) : /* 发 送 数据 令 牌 */ 
if (token ! =OxFD) | /* 数据 令 牌 */ 
wc =0: 
do | /* 发送 312 字 节 的 数据 块 到 MMC */ 


xmit_spi( * buff ++ ) ; 
xmit_spi( * buff ++ ) ; 














| while ( -- wc) : 


xmit_spi( OxFF ) ; /* 发 送 2 个 伪 CRC 人 码 */ 
xmit_spi(OxFF) ; 
resp = revr_spi( ) ; /* 接收 数据 响应 */ 
并 ((resp & Ox1F) ! =0x05) /x 如果 写 和 512 字 节 未 被 接收 ， 
return FALSE; 则 返回 错误 , 见 图 15-16 中 的 SD 卡 数据 输出 线 */ 





| 
return TRUE: 


1 
i 


#endif /* 只 读 (_READONLY) */ 
/* */ 
/* 发 送 命令 包 到 MMC 卡 , 见 表 15-6 
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表 15-6 SD 卡 的 命令 格式 














字 节 1 字 节 2 ~5( 人 参数 命令 ) 字 节 6 
0 1 CMD 高 位 在 前 (参考 可 以 为 空 ) CRC 1 

*/ 
/* */ 
static 
BYTE send_cmd ( 

BYTE cmd ， /* 命令 字 节 六/ 

DWORD arg /* 参 数 */ 
) 


BYTE n ,res; 
if (wait_ready( ) ! =OxFF ) return OxFF; 
/* 发 送 命令 包 ( CDM +4 个 字 节 的 参数 +2 个 伪 CRC 码 , 见 表 15-3) */ 





xmit_spi( cmd ) ; ]/ 命令 =/ 

xmit_spi( ( BYTE) (arg > 24 ) ) : /* 参数 [31 -24] */ 

xmit_spi( ( BYTE) (arg > 16 ) ) : /* 参数 [23 -16] */ 

xmit_spi( ( BYTE)(arg >8) ) : /* 参 数 [15 ~8] */ 

xmit_spi( ( BYTE ) arg) ; /* 参数 [7 -0] */ 

n = Oxff; 

if (cmd == CMDO)n =0x95; /* CMD0(0, 即 参数 为 0) 的 CRC 码 */ 

if (cmd == CMD8)n =0x87; /* CMD8(0x1AA, 即 参数 为 0x1AA) 的 CRC 码 */ 


xmit_spi(n) ; 


/* 接收 命令 响应 * 7 








if (cmd == CMD12 )revr_spi( ) ; /* 当 停 止 读数 时 跳 过 一 个 填充 字 节 */ 
n=10; /* 等 竺 有 效 响应 在 10 次 尝试 后 超时 */ 
do 


res = revr_spi( ) ; 
while ( (res & 0x80) && ——n); 
return res; /* 返回 响应 值 */ 


! 
} 


/* * 
* 发 送 用 于 终止 多 扇 区 读 取 的 特殊 命令 , 见 表 15-7 


表 15-7 SD 卡 的 命令 格式 




















字 节 1 字 节 2 ~5( 人 参数 命令 ) 字 节 6 
0 1 CMD 高 位 在 前 (参考 可 以 为 空 ) CRC 1 
水 */ 
static 


BYTE send_cmdl2 (void) 


| 
( 


BYTE n,res ,val; 

/* 对 于 CMD12 ,在 发 送 新 的 命令 前 不 必 等 待 该 卡 进 入 空闲 状态 * / 
/* 发 送 命令 包 - CMD12 的 参数 将 被 忽略 * / 

xmit_spi( CMD12 ) ; 

xmit_spi( 0 ) ; 








xmit_spi( 0 ) ; 


xmit_spi( 0) ; 
xmit_spi( 0) ; 
xmit_spi( 0) ; 
/* 从 卡 中 最 多 读 取 10 个 字 节 的 数据 , 记 住 哪些 读 出 的 值 不 是 0xFF 的 数据 * / 
for(n=0; n<10; n++) 
| 
val = revr_spi( ) ; 
if( val ! =OxFF) 
| 





















































res = val ; 
| 
| 

return res; /* 返回 响应 值 x*/ 
| 
/* 
公共 函数 

*/ 
/ * */ 
/* 卡 的 初始 化 */ 
/* */ 
*/ 

DSTATUS disk_initialize ( 

BYTE drv /* 物理 驱动 顺 号 (0) */ 
) 
| 

BYTE n,ty,ocr[4]; 

if (drv) return STA_NOINIT; /* 只 支持 单个 驱动 器 */ 

if (Stat & STA_NODISK ) return Stat; /* 卡 没有 插入 */ 

power_on( ) ; /* 接 通 卡 槽 的 电源 */ 

send_initial_clock_train( ) ; /* 确保 卡 处 于 SPI 模式 (延迟 80 个 时 钟 ) * 7/ 

SELECT( ) ; /* 将 片 选 (CS ) 信 号 拉 低 * ノ 

ty =0; 

if (send_cmd(CMD0,0) ==1) | /* 进入 空 亲 状态 (如 图 15-7、 图 15-8 所 示 ) */ 

Timerl = 100; /*100 ms 初始 化 超时 */ 


这 (send_cmd (CMD8,0x1AA) ==1) | /*SDC Ver2 + ,SD 卡 强制 规范 ,如 图 15-7、 
图 15-8 中 CMD8 的 说 明 , 基 中 0xlAA 为 4 字 节 
的 参 数 * ノ 
for (n =0: n <4: n ++ )ocr[ n] =rcvr_spi( ) : /* 读 取 OCR 寄 存 妖 的 代 */ 
if (ocr[2] ==0x01 && ocr[ 3] ==OxAA) | /* 二 的 VDD 范围 为 2.7 ~3.6V, 查 阅 
CMD8 寄存 器 描述 */ 

















do | 
if (send_cmd( CMD55,0) <=1 && send_cmd( CMD41 , \ 
1UL <<30) ==0)break; /* 设 置 ACMD41 的 HCS 位 (30 位 )( 即 区 
别 卡 的 类 型 ,1 =SDHC 卡 ,0 =SDSC 卡 ) */ 























| while (Timerl ) ; 
if (Timerl && send_cmd( CMD58,0) ==0)1 Z*SD 卡 2.0 初 始 化 成 功 ,检查 


CCS 位 ,如 图 15-8 所 示 */ 
for (n=0; n<4; n++ )ocr[n| =revr_spi( ) : 
ty= (ocr[0] & 0x40)? 6: 2: 
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| 


| els 


| 
e | /* 无 响应 , 则 SD 卡 为 SDC 1.x 版本 或 MMC 的 卡 */ 
ty =(send_cmd(CMDSS ,0) <=1 && send_cmd( CMD41,0) <=1)?2.1; 
/*SDC: MMC 卡 (如 图 15-8 所 示 ) */ 
do | 
if (ty ==2)| 
if (send_cmd( CMD55,0) <=1 && send_cmd( CMD41,0) ==0) break; 
/* ACMD41( 如 图 15-8 所 示 ) */ 
| else | 
f(send_cmd( CMD1,0) ==0)break; /x* CMD1, 男 外 初始 化 MMC 卡 */ 
| 
| while ( Timerl ) ; 
if (1Timerl | send_cmd( CMD16 ,512) ! =0) /* 选择 R/W 模块 长 度 */ 








ty=0; 

| 
| 
CardType = by: 
DESELECT( ) ; /* 拉 高 CS 信号, 即 CS=H */ 
revr_sDi( ) ; /* 空 闪 (释放 DO) */ 
if (ty)| /* 初始 化 成 功 */ 

Stat & = ~ STA_NOINIT; /* 清除 STA_NOINIT */ 

set_max_speed( ) : /* 时 钟 频率 应 小 于 400 kHz * / 
| else | /* 初始 化 失败 */ 


power_off( ) : 


| 


return Stat ; 























ノ * */ 
/* 获取 SD 卡 状 态 * ノ 
/* */ 
DSTATUS disk_status ( 

BYTE drv /* 物理 驱动 器 号 (0) */ 
) 
| 

if (drv) return STA_NOINIT; /* 只 支持 单个 驱动 器 */ 

return Stat ; 
| 
/* */ 
/* 读 局 区 ( 见 图 15-9 ~11) 
ノ * */ 


DRESULT disk_read ( 











BYTE drv, /* 物理 驱动 器 号 (0) */ 

BYTE * buff， /* 指向 存储 读 出 数据 的 缓冲 区 指针 */ 
DWORD sector, /* 起 始 户 区 号 (LBA) * / 

BYTE count /* 局 区 计数 (1 ~255)*/ 


if (drv | lcount) return RES_PARERR ; 


if (Stat & STA_NOINIT)return RES_NOTRDY ; 


if (1(CardType & 4) )sector * =512; /* 如 果 需 要 可 转换 为 字 节 地 址 */ 
SELECT( ) ; /*CS=L */ 
if (count ==1)| /* 读 单 块 */ 

if ((send_cmd( CMD17 ,sector) ==0) /* 读 单个 块 (如 图 15-9 所 示 ) */ 








&& revr_datablock( buff,512)) 


count =0; 
| 
else | /* 多 个 块 */ 
if (send_cmd( CMD18 ,sector) ==0) | /+* 读 多 个 块 */ 
do | 
if (lrevr_datablock( buff,512) ) break; 
buff +=512; 
| while ( —-count) ; 
send_cmd12( ) ; /* 停止 传输 * 7/ 
| 
| 
DESELECT( ) ; /A*CS=H */ 
revr_sDi( ) ; /* 室 内 (释放 DO) */ 


return count ? RES_ERROR: RES_OK: 


1 
1 





/ * 
/* 写 扇 区 (如 图 15-9 图 15-12 .图 15-13 所 示 ) 

















/* 
#if _READONLY == 
DRESULT disk_write ( 


BYTE drv， /* 物理 驱动 器 号 (0) */ 
const BYTE * buff, /* 指向 要 写 人 数 据 的 指針 */ 
DWORD sector, /* 起 始 扇 区 号 (LBA) */ 
BYTE count /* 局 区 计数 (1 ~255) */ 





if (drv | lcount) return RES_PARERR ; 
if (Stat & STA_NOINIT) return RES_NOTRDY; 
if (Stat & STA_PROTECT ) return RES_WRPRT; 





if (!(CardType & 4) ) sector * =512; /* 如 果 需 要 可 转换 为 字 节 地 址 */ 
SELECT( ) ; ノ /* CS =L */ 
if (count ==1 ) 1 /* 单 块 写 人 (如 图 15-12 所 示 ) */ 


if ( (send_cmd( CMD24 ,sector) ==0) /*#* 单 块 写 人 =*/ 
&& xmit_datablock( buff ,OxFE) ) 
count =0; 
| 
else | /* 多 块 写 */ 
if (CardType & 2) 1 
send_cmd( CMDSS ,0) ; send_cmd( CMD23 ,count ) ; /* ACMD23 */ 
1 
if (send_cmd( CMD25 ,sector) ==0) | /* 多 块 写 */ 
do | 
if (1!xmit_datablock(buff,OxFC) ) break: 


*/ 
ネン 
*/ 
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buff +=512; 





| while ( —— count); 
if (lxmit_datablock( 0 ,0xFD ) ) /* 停止 传输 令 牌 */ 
count =1; 
| 
| 
DESELECT( ) ; /* CS=H */ 
revr_sDi( ) ; /*# 空 闲 (释放 DO) */ 


return count ? RES_ERROR: RES_OK: 


1 
i 


#endif/ * 只 读 */ 




































































/ * 
/* 多 种 功能 
/* 
DRESULT disk_ioctl ( 
BYTE drv, /* 物理 驱动 器 号 (0) */ 
BYTE curl, /* 控制 代码 * / 
void *buff /* 发 送 /接收 控制 数据 缓冲 区 * / 
) 
| 
DRESULT res; 
BYTE n,csd[ 16], * ptr = buff; 
WORD csize; 
if (drv) return RES_PARERR ; 
res =RES_ERROR: 
if (crl == CTRL_POWER) |{ 
switch ( *ptr) 1 
case 0: /* 子 控制 代码 ==0 (电源 关 断 ) */ 
if (chk_power( ) ) 
power_off( ) ; /* 共 断 申 源 */ 
res =RES_OK: 
break ; 
case 1 : /* 子 控制 代码 ==1 (电源 接 通 ) * ノ 
power_on( ) ; /* Power on */ 
res =RES_OK: 
break ; 
case 2: /* 子 控制 代码 ==2 (获得 电源 ) * / 
* (ptr+1) =( BYTE)chk_power( ); 
res = RES_OK; 
break; 
default: 
res = RES_PARERR; 
| 
| 
else | 
if (Stat & STA_NOINIT) return RES_ NOTRDY ; 
SELECT( ); /* CS =L */ 
switch ( ctrl) | 
case CET_SECTOR_COUNT: /* 获取 卡 的 上 扇 区 数 (DWORD) */ 


*/ 
*/ 
*/ 


// 
Lf 
// 
// 


if ((send_cmd( CMD9 ,0) ==0)&& revr_datablock( csd ,16 ) ) | 
if ((csd[0] >6) ==1) /* SDC ver 2.00 */ 
csize =csd[ 9] + ((WORD) csd[ 8] «8) +1: 
* (DWORD * ) buff = (DWORD ) csize < 10; 
| else { /* MMC 或 SDC ver 1.xx */ 
n=(csd[5] &15) +((csd[ 10] &128) >7) + \ 
((esd[9] &3) <<1) +2; 
csize = (csd[8] >6) + (( WORD) csd[ 7] «2) +\ 
((WORD) (csd[ 6] &3) «10) +1; 
* (DWORD * ) buff = (DWORD) csize < (n -9): 
| 
res = RES_OK: 
| 
break ; 
case CET_ SECTOR_SIZE /* 得 到 扇 区 (WORD) */ 
* (WORD * ) buff =512; 
res =RES_OK: 
break ; 
case CTRL_SYNC: /* 确保 数据 已 写 入 */ 
if (wait_ready( ) ==OxET ) 
res = RES_OK: 
break ; 
case MMC_GET_CSD: /* 接收 CSD 作为 一 个 数据 块 (16 字 节 ) */ 
if (send_cmd( CMD9,0) ==0 /#* 读 CSD */ 
&& rcvr_datablock( ptr,16 ) ) 
res = RES_OK: 
break ; 
case MMC_GET_CID: /* 接收 CID 作为 一 个 数据 块 (16 字 节 ) */ 
if (send_cmd(CMD10 ,0 ) ==0 /* 所 CID */ 
&& revr_datablock( ptr,16 ) ) 
res = RES_OK: 
break ; 
case MMC_GET_OCR: /* 接收 OCR 作为 R3 的 响应 (4 字 节 ) */ 
if (send_cmd(CMD58 ,0) ==0) 1 /#* 读 OCR */ 
for (n=0; n<4; n++) 
* ptr ++= revr_spi( ) ; 





res = RES_OK; 
1 
1 
case MMC_CET_TYPE: /* 获取 卡 的 类 型 标志 (1 字 节 ) */ 
* ptr = CardType; 
res = RES_OK; 
break; 


default: 
res =RES_PARERR: 


1 


DESELECT( ) ; /*CS=H */ 
revr_spi( ) ; /* 空 闪 ( 释 放 DO) */ 
| 
return res ; 
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| 


/* 









































*/ 

/* 设备 定时 顺 中 断 程序 (依赖 于 平台 ) * / 
/* */ 
/* 这 个 函数 必须 在 10 ms 之 内 调用 の 
void disk timerproc (void ) 
| 
// BYTE n,s; 

BYTE n; 

n= Timerl ; /* 100Hz 递增 定时 器 / 

if (n)Timerl = -一 ni 

n= Timer2 ; 

if (n) Timer2 = ーー-n: 
| 
A */ 
/* 用 户 给 FatFS 模块 提供 的 定时 函数 */ 
/* */ 





/* 这 是 一 个 从 FatFS 模块 调用 的 实时 时 钟 服务 * / 

/* 任何 有 效 时 间 必 须 被 返回 ,即使 系统 不 支持 实时 时 钟 */ 
DWORD get_fattime (void ) 

| 

1 


return ( (2007UL - 1980 ) <<23 ) // 年 =2007 





| (6UL <<21 ) // 月 = June 
| (SUL < 16) // 日 =5 

| (11U <<11) // 時 =11 

| (38U «35) // 分 =38 

| (0U >1) // 秒 =0 


5 
! 
| 


FatFS 文件 系统 简介 


FatFS 是 小 型 蔡 入 式 系 统 的 通用 FAT 文件 系统 模块 。FatFS 由 符合 


并 和 磁盘 LO 层 完 全 分 离 ， 因 此 它 是 独立 于 硬件 架构 的 ， 如 
图 15-17 所 示 。 

1. 特 点 

1) Windows 兼容 的 FAT 文件 系统 。 

2) 独立 于 平台 易于 移植 。 

3) 代码 和 工作 区 占用 空间 很 小 。 

4) 各 种 配置 选项 。 


5) 多 卷 (物理 驱动 器 和 分 区 ) 。 图 
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ANSI C 的 C 语言 编写 




















15-17 文件 系统 机 





况 目 


① 多 ANSI/OEM 代码 页 ， 包 括 DBCS。 
② 支持 在 ANSI/OEM 或 Unicode 中 的 长 文件 名 。 
③ RTOS 支持 。 
④ 多 扇 区 大 小 支持 。 
⑤ 只 读 ， 最 少 APIL/O 与 缓冲 区 等 。 
2. 应 用 程序 接口 
1) FatFS 文件 系统 的 源 文 件 夹 中 的 文件 如 下 : 
① ec936c: 为 支持 简体 中 文 的 程序 ， 其 包括 简体 中 文 的 GBK 和 转换 函数 。 
② diskio. h: 底层 磁盘 接口 模块 中 的 包含 文件 。 
③ diskio. c: FatFS 文件 系统 中 ， 底 层 磁盘 0 模块 骨架 的 实现 代码 。 需 用 户 根据 实际 情 
行 修改 。 
④ integer.h: FatFS 模块 的 整数 类 型 定义 。 
@) 华 h: R0. 09bFAT 文件 系统 模块 的 包含 文件 ， 需 用 户 按 实 际 情况 稍 作 修改 。 
© 在 ce: RO. 09bFAT 文件 系统 模块 的 实现 代码 。 
CO ffconf h: FAT 文件 系统 的 模块 配置 文件 ， 需 用 户 自行 修改 。 
2) 实现 FatFS 模块 的 固件 库 函 数 见 表 15-8。 
表 15-8 FatFS 固件 库 函 数列 表 

























































































































































































函数 描 述 函数 描 述 
_open 打开 /创建 一 个 文件 _chdir 改变 当前 目录 
_close 关闭 打开 的 文件 _chdrive 改变 当前 驱动 器 
~_read 读 取 文件 _getewd 检索 当前 目录 
_wrlte 写 入 文件 _getfree 获得 空闲 篮 的 个 数 
_lseek 移动 读 / 写 指针 来 扩展 文件 大 小 _getlabel 获取 卷 标 
_truncate 截断 文件 大 小 _setlabel 设置 卷 标 
_sync 刷新 缓存 的 数据 _mount 注册 /注销 一 个 工作 区 
_forward 读 取 文件 数据 并 转发 到 数据 流 _mkfs 在 磁盘 上 创建 一 个 文件 系统 
_stat 检查 存在 的 文件 或 子 目 录 _fdisk 划分 物理 驱动 器 
_opendir 打开 一 个 目录 _gets 读 一 个 字符 串 
_closedir 关闭 打开 的 目录 _putc 写 一 个 字符 
_readdir 读 取 目 录 项 _puts 写 一 个 字符 串 
_mkdir 创建 一 个 子 目 录 _printf 写 一 个 格式 化 字符 串 
_unlink I 除 一 个 文件 或 子 目 录 _tell 获取 当前 的 读 / 写 指针 
_chmod 更改 属性 _eof 测试 一 个 文件 结束 
_utime 更 改 时 间 惟 _size 获取 文件 的 大 小 
_rename 重 命名 /移动 文件 或 子 目录 _error 测试 一 个 文件 中 的 错误 





























注 : FatFS 文件 系统 网 址 为 http://elm - chan. org/fsw/ff/00index_e. html。 


实验 硬件 连接 图 


图 15-18 是 TI 公司 BD - LM4F232 评估 板 的 microSD 卡 的 硬件 连接 图 (对 于 仅 有 
LaunchPad: EK - TM4C123GXL 板 的 读者 ， 可 以 参照 该 连 线 图 在 面包 板 中 给 LaunchPad 板 扩 


展 一 个 microSD 卡 槽 ) ， 采 用 SSI 模式 实现 与 微 控制 器 通信 。 然 后 创建 一 


























操作 的 UART 控制 台 ， 即 通过 上 位 机 发 送 命令 来 访问 microSD 卡 。 





个 能 显示 SD 卡 访问 
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microSD CARD INTERFACE 








PA3/SSIOFSS_SDCS 
PAS/SSIOTX SDDI 








PA2/SSIOCLK_SDCLK 





PA4/SSIORX_SDD0 < 














图 15-18 SD 卡 的 硬件 连接 图 
导入 sd_card 工程 





1) FatFS 文件 读 取 程 序 说 明 。 下 面 将 以 TI 提供 的 一 个 简单 的 FatFS 读 取 为 例 来 介绍 程 


序 的 编写 。 
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クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ チキ キキ 3 
// 文 件 名 :sd_card. c 

// 来 源 :TI 例 程 

// 功 能 描述 :此 例 程 演示 从 SD 卡 上 读 取 文件 系统 。 采 用 FAT32 文件 系统 驱动 的 FatFS ,可 通过 UART 
// 上 串口 命令 来 查看 操作 SD 卡 上 的 文件 系统 ,包括 在 PuTTY 或 串口 助手 上 输入 help 命令 获取 帮助 信息 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
Pash // 包 含 文件 略 

#include "utils/cmdline. h" 

#include "utils/uartstdio. h" 

#include "fatfs/ src/ff. h" 

#include "fatfs/ src/ diskio. h" 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ チキ キキ キキ : 
// 定 义 了 保存 路 径 的 缓冲 区 大 小 ,或 来 自 于 SD 卡 的 临时 数据 大 小 

// 分 配 这 两 个 缓冲 区 的 大 小 必须 足够 大 ,以 便 能 保存 所 需 的 完整 路 径 名 

// 包 括 文件 名 和 结尾 的 空 字 符 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
#define PATH_BUF_SIZE 80 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キチ キキ キキ : 
// 定 义 缓冲 区 大 小 来 保存 命令 行 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ チキ テキ キキ: 
#define CMD_BUF_SIZE 64 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ チキ キキ キキ : 
// 这 个 缓冲 区 保存 当前 工作 目录 的 完整 路 径 ,其 中 “/” 为 根 目录 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そ : 
static char g_pcCwdBuf| PATH_BUF_SIZE | = リノ ": 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 3 
// 在 操作 文件 路 径 时 会 使 用 到 临时 数据 缓冲 区 ,或 从 SD 卡 中 读 取 数据 

クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そ : 


static char g_ pcTmpBuf| PATH_BUF_SIZE ] : 












































// ネネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ネネ ポ ネ ポポ ネネ ポポ ポポ ネネ ポポ ネネ 
A Sv 

// 保 存 命令 行 的 缓冲 区 

// ネネ ホネ ポポ ネ ポ ポポ ネ ポポ ポポ ネネ ポポ ポポ ボネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ポポ ネ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ネネ ポポ ネネ 


static char g_pcCmdBuf[ CMD_BUF_SIZE | : 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ネネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


// 下 面 是 所 用 FatFS 的 数据 结构 


// ネネ ネネ ネネ ポポ ネネ ポポ ボネ ポポ ボネ ポポ ボネ ポポ ポポ ボネ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 




















static FatFS g_sFatFs; 
static DIR g_sDirObject; 
static FILINFO g_sFilelnfo; 
static FIL g_sFileObject; 


だ ホホ ポポ ホ ポポ ホホ ポポ ポポ ホホ ポ ホ ポポ ホホ ポポ ホホ ポポ ホホ ポポ ポポ ポポ ホホ ポポ ホホ ポ ホ ポポ ポポ ホ ポポ ホホ ポポ ポポ ホホ ポ ホ ポポ ポポ ホホ ポポ ホホ ホホ ポ ホ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ 
// 保 存 fresult 数值 代码 之 间 的 映射 结构 ,以 及 字符 串 表 示 形 式 
// 从 FatFS FAT 文件 系统 驱动 程序 中 返回 FRESULT 代码 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





typedef struct 


FRESULT iFResult; 
char * pcResultStr; 
tFResultString; 
ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ: 


// 定 义 一 个 宏 可 很 容易 将 结果 代码 添加 到 表 中 
天 这 ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
#define FRESULT_ENTRY(f) 1 (f) ,( 将 ) | 

这 ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ホホ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ 
// 一 个 保存 数值 FRESULT 代码 之 间 映 射 的 表 与 其 名 称 的 字符 
// 这 可 用 于 在 UART 控制 台 上 打印 查找 到 的 错误 代码 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 











Ud 
































tFResultString g_psFResultStrings| ] = 

| 
FRESULT_ENTRY( FR_OK), 
FRESULT_ENTRY( FR_DISK_ERR), 
FRESULT_ENTRY( FR_INT_ERR), 
FRESULT_ENTRY( FR_NOT_READY), 
FRESULT_ENTRY( FR_NO_FILE), 
FRESULT_ENTRY(FR_NO_PATH ) , 
FRESULT_ENTRY(FR_INVALID_NAME ) , 
FRESULT_ENTRY(FR_DENIPED ) , 
FRESULT_ENTRY(FR_EXIST ) , 
FRESULT ENTRY(FR_INVALID_OBJECT) , 
FRESULT_ENTRY(FR_WRITE_PROTECTED ) , 
FRESULT_ENTRY(FR_INVALID_DRIVE ) , 
FRESULT_ENTRY(FR_NOT_ENABLED ) , 
FRESULT_ENTRY(FR_NO_FILESYSTEM ) , 
FRESULT_ENTRY(FR_MKEFS_ABORTPD ) , 
FRESULT_ENTRY(FR_TIMEOUT) , 
FRESULT_ENTRY(FR_LOCKED ) , 
FRESULT_ENTRY(FR_NOT_ENOUGH_CORE) , 
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FRESULT_ENTRY(FR_TOO_MANY_OPEN_EILES) , 
FRESULT_ENTRY(FR_INVALID_PARAMETER ) , 





) 
1 5 


レク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ 

// 定 义 保存 结果 代码 个 数 的 宏 

ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ: 

#define NUM_FRESULT_CODES (sizeof(g_psFResultStrings )/ \ 
sizeof( tFResultString ) ) 

ンク キキ キキ キキ キキ ギ キキ キキ キキ キキ テキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ キテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ: 

// 图 形 上 下 文 用 来 在 CSTN 显示 屏 上 显示 文字 


// ネネ ネネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 








tContext g_sContext; 
ノノ 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 永 来 求 来 来 来 求 来 来 来 求 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 求 来 来 


// 在 调用 FatFS 函数 时 该 函数 返回 一 个 错误 代码 的 字符 串 表 示 形 式 , 可 用 于 打印 可 读 的 错误 消息 


// ネネ ボネ ネネ ポ ボネ ボネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 



































const char * 

StringFromFResult( FRESULT iFResult) 

| 
uint_fast8_t ui8Idx ; 
// 进 入 一 个 循环 来 搜索 与 错误 代码 表 中 匹配 的 错误 代码 
for( ui8Idx =0; ui8ldx < NUM_FRESULT_CODES; ui8Idx ++ ) 
| 





/A/ 如 果 找 到 一 个 匹配 , 则 返回 错误 代码 的 字符 串 名 称 
if( g_psFResultStrings| ui8Idx ]. iFResult == iFResult) 
| 





return( g_psF ResultStrings[ ui8Idx ]. pcResultStr) ; 


| 
// 阁 在 该 点 上 没有 发 现 匹 配 的 代码 , 则 返回 一 个 指示 未 知 错误 的 字符 
retum("UNKNOWN ERROR CODE" ) ; 


Ud 








| 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ネギ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 


// 处 理 SysTick 的 中 断 。FatFS 因 内 部 定时 的 目的 需要 一 个 10 ms 的 滴答 (系统 ) 计时 器 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポ ネ ポポ 





void 
SysTickHandler( void ) 
| 
// 调 用 FatFs 滴答 (系统 ) 计 时 器 
disk_timerproc( ) ; 
| 
クキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ : 
// 该 函数 执行 "18” 命 令 。 它 可 打开 当前 目录 ,详细 显示 其 中 内 容 , 如 文件 属性 .时间 .日 期 文件 大 
// 小 和 名 称 等 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポ ネ ポポ 














| 











int 
Cmd_ls(int argc,char * argv[ | ) 
| 
uint32_t ui32TotalSize; 
uint32_t ui32FileCount; 


uint32_t ui32DirCount ; 
FRESULT iFResult: 
FatFS  * psFatFs; 
char * peFileName ; 
#if _USE_LFN 
char pucLfn[ _MAX_LFN +1 | : 
g_sFilelnfo. lfname = pucLfn; 
g_sFilelnfo. lfsize = sizeof( pucLfn) ; 
#endif 
// 打 开 当 前 要 访问 的 目录 
iFResult =f_opendir( &g_sDirObject,g_pcCwdBuf) ; 
// 检 查 错 误 , 若 有 问题 将 返回 
if(iFResult ! =FR_OK) 
| 





return( (int) iFResult) ; 
| 
ui32TotalSize =0; 
ui32FileCount =0; 
ui32DirCount =0; 
/添加 一 空 行 ( 即 换行 ) 
UARTprintf(" \n" ) ; 
// 通 过 循环 来 枚 举目 录 中 的 所 有 条 目 
































for( ;;) 
| 
// 读 取 目 录 中 的 条 目 





iFResult =f_readdir( &g_sDirObject, &g_sFileInfo) ; 
// 检 查 错误 , 若 有 问题 将 返回 

if(iFResult ! =FR_OK) 

| 








return( (int) iFResult) ; 
| 
// 如 果 文 件 名 为 空 ,那么 这 就 是 列表 的 末尾 
// // 
if( lg_sFileInfo. fname[0]) 
| 





break; 
} 
1 
// 如 果 属 性 是 目录 , 则 将 目录 的 个 数 +1 
if(g_sFileInfo. fattrib & AM_DIR ) 
| 














ui32DirCount ++ ; 


1 
i 


// 否 则 , 它 是 一 个 文件 来。 并 使 文件 个 数 +1, 同 时 将 文件 大 小 添加 到 总 计数 值 中 
else 


| 











ui32FileCount ++ ; 

ui32TotalSize +=g_sFilelnfo. fsize; 
} 
i 


#if _USE_LFN 
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pcFileName = (( * g_sFileInfo. lfname)? g_sFileInfo. lfname:g_sFileInfo. fname ) ; 
#else 

pcFileName = g_sFilelnfo. fname: 
#endif 





























// 用 单独 一 行 格式 打印 条 目 信 息 以 显示 :属性 日期. 时间、 大 小 和 名 称 
UARTprintf("%c%c%c%c%c %u/%02u/%02u %02u.%02u Wu Ws\n", 


(g_sFilelnfo. fattrib & AM_DIR)7 D : -, 
(g_sFilelnfo. fattrib & AM_RDO)7 R :一 ， 
(g_sFilelnfo. fattrib & AM_HID)?7 H :二 ， 
(g_sFilelnfo. fattrib & AM_SYS) 7 S : 二 ， 

(g_sFilelnfo. fatrib & AM_ARC) 7 A ーー, 


(g_sFileInfo. fdate >9 ) +1980, 
(g_sFileInfo. fdate >>5)& 15, 
g_skilelnfo. fdate & 31 , 
(g_sFileInfo. fiime >> 11 ) , 
(g_sFileInfo. ftime >> 5 ) 63, 
g_skilelnfo. fsize , 
pchileName ) ; 
| 
// 打 印 汇总 行 来 显示 文件 .目录 和 大 小 的 总 数 
UARTprintf(" \n%4u File(s) ,% 10u bytes total \n% 4u Dir(s)" ， 
ui32FileCount,ui32TotalSize ,ui32DirCount ) ; 
// 获 取 可 用 空间 
iFResult =f_getfiree("/" ,(DWORD * )&ui32TotalSize ,&psFatFs ) ; 
// 检 查 错误 , 若 有 问题 将 返回 
if(iFResult ! =FR_OK) 
| 




















return( (int) iFResult) ; 
| 
/显示 计算 得 出 的 可 用 空间 大 小 
UARTprintf(" ,和 10uK bytes free\n" , (ui32TotalSize * 
psFatFs > free_clust/2) ) ; 














// 到 了 这 里 ,没有 错误 则 返回 0。 

return(0); 
| 
クル キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キミ: 
// 该 函数 执行 “cd” 命令 。 它 需要 一 个 参数 来 指定 当前 的 工作 目录 
// 路 径 分 隔 符 必须 使 用 正 斜 杜 “/”。 cd 的 参数 可 以 是 下 列 之 一 : 
A//* 根 目录 ("/") 
//* 指定 完整 的 路 径 ("/my/path/to/ mydir" ) 
//* 当前 目录 的 单个 目录 名 ("mydir" ) 
/AL* 父 目录 ("..") 
// 不 文 持 相对 路 径 , 所 以 不 要 尝试 如 下 的 操作 : 
//("../my/new/path" ) 
// 一 旦 指定 了 新 目录 , 它 会 尝试 打开 该 目录 ,以 确保 其 存在 
// 如 果 新 路 径 成 功 打 开 , 则 当前 工作 目录 ( CWD) 改 为 新 的 路 径 


// ネネ ボネ ネネ ポポ ネネ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 






































int 
Cmd_cd(int argc,char *argv| | ) 
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uint_fast8_t ui8Idx ; 
FRESULT iFResult: 
// 将 当前 工作 路 径 复制 到 一 个 临时 缓冲 区 中 ,以 便 对 它 进 行 操作 


strcpy(g_pcTmpBuf,g_pcCwdBuf) ; 























// 如 果 第 一 个 字符 是 “/”, 那 么 这 是 一 个 完全 指定 的 路 径 , 且 它 应 该 只 当 作 "是 ” 
if(argv[ 1][0] = ミア ) 


| 


| 








凶 


/人 /确保 新 路 径 不 大 于 CWD 缓冲 
if(strlen(argv[1]) + 1 >sizeof(g_pcCwdBuf) ) 
| 








UARTprintf(" Resulting path name is too long\n" ) ; 


return( 0 ) ; 
| 


i 

// 如 果 新 路 径 名 (argv 中 [1] ) 不 太 长 ,那么 将 其 复制 到 临时 缓冲 区 ,以 便 
// 可 对 它 进一步 的 检测 

else 


| 











strncpy( g_pcTmpBuf ,argv| 1 | ,sizeof(g_pcTmpBuf) ) ; 


1 
i 


// 如 果 参 数 是 “..”, 将 尝试 删除 CWD 的 最 底层 


else 


| 


| 


/和 否则 ,这 只 是 一 个 来 自 当 前 目录 的 正常 的 路 径 名 ,并 需要 将 其 添加 到 当前 路 径 中 


else 


| 





if( lstremp(arev[ 1],"..")) 


// 在 当前 路 径 中 得 到 最 后 一 个 字符 的 引 索 

ui8Idx = strlen( g_pcTmpBuf) -1: 

// 备 份 路 径 名 的 末尾 ,直到 出 现 分 隔 符 (7) ,或 过 到 路 径 的 起 始点 为 止 
while((g_pcTmpBuf[ ui8Idx] 1! ミア )&& (ui8Idx >1)) 

| 





























// 备 份 一 个 字符 
ui8Idx —— : 
| 
// 现 在 要 么 在 当前 路 径 中 的 最 底层 分 隔 符 (目录 ) ,要 么 在 字符 串 的 开头 ( 根 目 录 ) 
// 所 以 设置 字符 串 新 的 结束 位 置 ,可 有 效 地 移 除了 路 径 的 最 后 部 分 
g_pcTmpBuf| ui8Idx] =0; 
























































// 测 试 添加 到 当前 路 径 上 新 的 附加 路 径 , 以 确保 对 于 完整 的 新 路 径 有 缓冲 空间 
// 它 需要 包括 一 个 新 的 分 隔 符 和 结尾 的 空 字 符 

if( strlen(g_pcTmpBuf) + strlen(argv[ 1]) +1 +1 >sizeof( g_pcCwdBuf) ) 

| 





UARTprintf(" Resulting path name is too long\n" ) ; 
return( 0 ) ; 
i 
// 新 路 径 正 确 , 所 以 添加 分 隔 符 ,然后 把 新 目录 添加 到 路 径 中 
else 


| 
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// 如 果 尚 未 在 根 目 录 , 那 么 添加 一 个 分 隔 符 “/” 
if(stremp(g_pcTmpBuf,"/" ) ) 
| 
strcat( g_pcTmpBuf,"/" ); 
| 
/添加 新 目录 到 路 径 中 
strcat( g_pcTmpBuf,argv[1]); 








| 
// 此 时 ,一 个 待 选 的 新 目录 路 径 在 chTmpBuf 中 。 尝 试 打开 它 来 确保 其 有 效 怕 
iFResult = f_opendir( &g_sDirObject,g_pcTmpBuf) ; 

// 如 果 它 不 能 被 打开 ,那么 这 是 一 个 条 错误 的 路 径 , 然 后 告知 用 户 并 返回 
if(iFResult ! =FR_OK) 

| 











FT 











UARTprintf( "cd: %s\n" ,g_pcTmpBuf) ; 
return( (int) iFResult) ; 
| 
// 否 则 , 它 是 一 条 有 效 的 新 路 径 , 所 以 将 其 复制 到 CWD 上 
else 
| 
strncpy( g_pcCwdBuf,g_pcTmpBuf, sizeof( g_pcCwdBuf) ) ; 
| 
// 返 回 成功 
return(0) ; 
| 
ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ : 
// 此 函数 执行 “PWD” 命 令 。 它 简单 地 打印 当前 的 工作 目录 


// ネネ ボネ ネネ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ボネ ポ ネ ポポ 








int 

Cmd_pwd(int argc,char * argv| | ) 

| 
// 打 印 CWD 到 控制 台 
UARTprintf(" % s\n" ,g_peCwdBuf) ; 
// 返 回 成功 


return(0) ; 





| 

クキ キキ キキ ギ キキ ギ キキ キキ キキ キキ キキ テテ テキ キキ キキ キキ キ キキ キキ キキ キキ キキ キテ テテ テテ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ: 
// 此 函数 执行 “cat” 命 令 。 它 读 取 文件 的 内 容 , 并 将 其 输出 到 控制 台 上 ,这 应 该 仅 用 于 文本 文件 
// 如 果 将 其 用 于 读 取 二 进 制 文件 ,那么 一 堆 无 用 输出 可 能 会 打印 在 控制 台 上 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ボネ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 












































int 
Cmd_cat(int argc,char * argv| | ) 
| 
FRESULT iFResult; 
uint32_t ui32BytesRead; 
// 首 先 ,判断 文件 名 ( 即 当 前 路 径 ( CWD) + 文件 名 + 一 个 分 阳 符 和 结尾 空 字符 ) 能 否 存放 到 
// 临 时 缓冲 区 中 
if(strlen(g_pcCwdBuf) + strlen( argv| 1 | ) +1 +1 > sizeof(g_pcTmpBuf) ) 
| 














UARTprintf(" Resulting path name is too long\n" ) ; 
return(0): 
| 
// 将 当前 路 径 复 制 到 临时 缓冲 区 中 ,以便 可 对 它 进 行 处 理 
strcpy(g_pcTmpBuf,g_pcCwdBuf) ; 
// 如 果 尚 未 在 根 目 录 下 , 则 需 添 加 一 个 分 隔 符 
ifCstremp("/" ,g_pcCwdBuf) ) 
| 











F 








strcat(g_pcTmpBuf "/" ) ; 
| 
// 最 后 ,添加 的 文件 名 被 存放 在 一 个 完全 指定 的 文件 中 
strcat( g_pcTmpBuf,argv| 1 ] ) ; 
// 读 取 打 开 的 文件 
iFResult =f_open( &g_sFileObject,g_pcTmpBuf, FA_READ) ; 
// 如 果 打 开 的 文件 中 存在 问题 将 返回 一 个 错误 
if(iFResult ! =FR_OK) 
| 











return( (int) iFResult) ; 
| 
// 进 入 一 个 循环 反复 从 文件 中 读 取 数据 并 显示 它 , 直 到 读 完 文件 为 止 
do 
| 


























// 从 文件 中 读 取 数据 块 

iFResult =f_read( &g_sFileObject,g_pcTmpBuf, sizeof( g_pcTmpBuf) - 1 ， 
Qui32BytesRead ) ; 

// 如 果 有 错误 读数 , 则 打印 一 个 换行 ,并 返回 错误 给 用 户 

if(iFResult ! =FR_OK) 

| 




















UARTprintf(" \n" ) ; 
return( (int) iFResult) ; 
| 
//0 作为 读 取 最 后 一 个 块 的 终止 符 
g_pcTmpBuf| ui32BytesRead | =0: 
// 打 印 接收 到 文件 的 最 后 一 个 块 
UARTprintf("%s" ,g_peTmpBuf) ; 
| 
while( ui32BytesRead == sizeof(g_pcTmpBuf) -1) ; 
// 返 回 成功 
return(0) ; 
| 
ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テテ テテ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ そそ そそ: 
// 此 函数 执行 “help” 命 令 。 打 印 可 用 的 附 简 要 说 明 的 简单 命令 列表 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 





int 
Cmd_help(int argc,char * argv[ | ) 
| 


tCmdLineEntry * psEntry: 
// 打 印 标 题 文 本 
UARTprintf( " \nAvailable commands \n" ) ; 
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了 30 


UARTprintf(" \n" ) ; 

// 指 向 命令 表 的 开始 

psEntry = &g_psCmdTable[ 0 ] ; 

// 进 入 一 个 循环 来 读 取 命 令 表 中 的 每 个 条 目 , 当 命 令 名 为 NULL 时 到 达 表 的 末尾 
while( psEntry > pcCmd) 

| 











// 打 印 命令 名 称 和 简要 说 明 

UARTprintf("%6s: % s\n" ,psEntry > pcCmd, psEntry > pcHelp); 
// 前 进 到 表 中 的 下 一 个 条 目 
psEntry ++ ; 














| 
// 返 回 成功 
return(0) ; 


1 
i 


レク キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キテ キキ キキ キキ キキ キキ キキ そ キネ: 
ロ プ テム 、 へ Bp 人 > 

// 该 表 保 存 命令 的 名 称 、 执 行 函 数 和 并 简要 描述 

レク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ テキ キキ キキ キキ キキ キテ そそ: 

tCmdLineEntry g_psCmdTable| ] = 


1 "help" , Cmd_help, "Display list of commands" | , 

1 "hv ， Cmd_help, "alias for help" | , 

MA Cmd_help, "alias for help" | , 

gt Cmd_ls, "Display list of files" | , 

| "cehdir" , Cmd_cd, "Change directory" 上 ， 

| "ed", Cmd_cd, "alias for chdir" 上 ， 

| "pwd" ， Cmd_pwd, "Show current working directory" | , 
1 "eat" , Cmd_cat , "Show contents of a text file" | , 

| 0,0,0 1 


| 


// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ 
ー > N= ヽ ゝ 

// 如 果 驱 动 程 序 库 遇 到 错误 时 调用 的 错误 处 理 程序 

// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボ ポポ ポポ ポポ ネネ ポポ 

#ifdef DEBUG 


void 








_ error_ (char * pceFilename ,uint32_t ui32Line ) 

| 

| 

#endif 

ノノ 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 来 ボ 
// 配 置 UART 和 相关 引 脚 。 必 须 在 调用 UARTprintf( ) 之 前 完成 配置 


// ネネ ネネ ネネ ポポ ボネ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ポポ ネネ ポポ 






































void 
ConfigureUART( void ) 
| 








// 使 能 用 于 UART 的 GPIO 外 设 
ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_CPIOA) ; 
// 使 能 UARTO 

ROM_SysCtlPeripheralEnable( SYSCTL_PERIPH_UARTO) ; 
/人 /配置 GPIO 引 脚 为 UART 模式 

















| 


ROM_CPIOPinConfigure( CPIO_PA0_UORX ) ; 

ROM_GPIOPinConfigure( GPIO_PA1_UOTX ) ; 
ROM_GPIOPinTypeUART(CPIO_PORTA_BASE,CPIO_PIN_0 | GPIO_PIN_1 ) ; 
// 使 用 内 部 16MHz 振荡 器 作为 UART 的 时 钟 源 

UARTClockSourceSet( UARTO_BASE,UART_CLOCK_PIOSC) ; 

// 初 始 化 UART 控制 台 IO 

UARTStdioConfig(0,115000,16000000)) ; 











// ネネ ボネ ネネ ポポ ボネ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ネネ ポポ ポポ ボボ ポポ ネネ ポポ 
// 主 函数 。 它 执行 初始 化 ,然后 运行 命令 处 理 循环 从 控制 台 读 取 命 令 


// ネネ ボネ ネネ ポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボネ ポポ 





int 





main( void ) 


| 


int nStatus; 

FRESULT iFResult; 

tRectangle sRect; 

ノ // 

ROM_FPULazyStackingEnable( ) ; 

/设置 系统 时 钟 运行 在 30 MHz 

ROM_SysCtlClockSet(SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_OSC_MAIN | 
SYSCTL_XTAL_ 16MHZ ) ; 

// 使 能 在 本 示例 中 使 用 的 外 设 

ROM_SysCtlPeripheralEnable(SYSCTL_PERIPH_SSIO ) ; 

// 设 置 系 统 定 时 器 每 100 Hz 产生 一 个 中 断 。 该 FatFS 驱动 需要 一 个 10 ms 的 滴答 时 钟 

ROM_SysTickPeriodSet( ROM_SysCtlClockGet( )/100) ; 

ROM_SysTickEnable( ) ; 

ROM_SysTickIntEnable( ) ; 

// 使 能 中 断 

ROM_IntMasterEnable( ) ; 

// 初 始 化 UART 作为 文本 1/0 控制 台 

ConfigureUART( ) ; 

// 初 始 化 显示 驱动 程序 

CFAL96x64x16Init( ) ; 

// 初 始 化 图 形 上 下 文 

GrContextInit( &g_sContext, &g_sCFAL96x64x16 ) ; 

// 在 屏幕 项 部 创建 一 个 蓝 色 条 

sRect. i16XMin =0; 

sRect. i16YMin =0; 

sRect. i16XMax = GrContextDpyWidthGet( &g_sContext) —1; 

sRect. 110YMax =9; 

GrContextForegroundSet( &g_sContext , ClrDarkBlue ) ; 

GrRectFill( &g_sContext , &sRect) ; 

[改变 前 景色 为 白色 文字 

GrContextForegroundSet( &g_sContext, ClrWhite ) ; 

// 把 应 用 程序 名 放置 在 蓝 色 条 的 中 间 

GrContextFontSet( &g_sContext,g_psFontFixed6x8 ) ; 

GrStringDrawCentered( &g_sContext,"sd_card" , —1, 
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// 在 屏幕 上 显示 指示 


GrContextDpyWidthGet( &g_sContext) /2,4,0); 


GrContextFontSet( &g_sContext,g_psFontFixed6x8 ) ; 


GrStringDrawCentered( &g_sContext," Connect a" , —1, 


GrContextDpyWidthGet( &g_sContext) /2 ,20 ,false) ; 


GrStringDrawCentered( &g_sContext," terminal" , — 


GrContextDpyWidthGet( &g_sContext) /2,30 ,false) ; 


GrStringDrawCentered( &g_sContext, "to UARTO.",—1, 


GrContextDpyWidthGet( &g_sContext ) /2 ,40 ,false) ; 


GrStringDrawCentered( &g_sContext, "115200,N,8,1" , -1, 


// 


// 打 印 帮 助 信 |， 








息 给 用 





GrContextDpyWidthGet( &g_sContext) /2,50 ,false) ; 





oH 








i 


UARTprintf(" \n\nSD Card Example Program\n" ) ; 
UARTprintf(" Type \ help\ for help. \n" ) ; 





// 挂 


载 文件 系统 





,使 








] 逻 辑 人 磁盘 0 








iFResult =f_mount(0,&g_sFatFs); 
if(iFResult ! =FR_OK) 


| 


| 


// 进 入 无 
while( 1) 


| 


UARTprintf("f_mount error: % s\n" , StringFromFResult (iFResult) ) ; 


return(1); 


// 打 印 提示 到 控 


限 循环 用 于 











用户 读 取 和 发 出 处 理 命令 











出 台 。 显 示 CWD 


UARTprintf(" \n% s >" ,g_peCwdBuf) ; 











// 从 用 户 获 取 一 行文 本 

UARTgets( g_pcCmdBuf, sizeof( g_pcCmdBuf) ) ; 

// 来 自用 户 的 命令 行将 被 解析 并 有 效 的 命令 执行 
nStatus = CmdLineProcess( g_peCmdBuf) ; 




















// 错 误 命 令 


| 


的 处 理 情况 


if( nStatus == 





CMDLINE_BAD_CMD) 


UARTprintf(" Bad command ! \n" ) ; 


| 


// 参 数 大多 的 处 理 情况 
else if( nStatus == CMDLINE_TOO_MANY_ARGS) 


| 





UARTprintf( "Too many arguments for command processorl \n" ) ; 


// 否 则 ,该 命令 执行 。 如 果 退 回 则 打印 错误 代码 
// // 


// 





else if(nStatus ! =0) 


| 


UARTprintf(" Command returned error code % s\n" , 


StringFromF Result( (FRESULT ) nStatus ) ) ; 


| 


2) 导入 sd_card 工程 ， 如 图 15-17 所 示 。 在 C:\ti\TivaWare_C_Series -2.0.1.11577\ex- 
amples\boards \dk - tm4c123g\sd_card 日 录 下 单 击 加 sd card 图 标 导 入 sd_card 工程 ， 如 
图 15-19 所 示 。 

3) 将 C:\ti\TivaWare_C_Series -2.0. 1. 11577 \third_party \fatfs \src \option 目录 下 支持 简 
体 中 文 的 文件 (cc936.c) 添加 到 工程 中 。 

4) 编译 工程 生成 可 执行 的 . axf 文件 ， 如 图 15-20 所 示 。 





日 - 滞 sd_ 






日 “入 Source 需 换 成 支持 







card 





[cc932c] 4 简体 中 文 的 


I96x64x16.c cc936.c 


FADgcumentation 


hd readme.txt 





图 





15-19 sd_card 工程 


$) 制作 测试 用 的 几 个 文件 。 
① 在读 卡 器 中 把 microSD 卡 格式 化 为 FAT32 格式 ， 按 如 图 15-21 所 示 设 置 。 


② 制作 文本 文件 和 文件 夹 ， 如 图 


图 15 








格式 化 可 移动 磁盘 (N) [| 
容量 (P) : 
1.88 GE | 
文件 系统 全 》 
[FaT32 (上 默认) 了 | 
分 配 单元 大 小 (8) 
| 贺 认 配 团 大 小 > 

还 原 设备 的 默认 值 OD) 

卷 标 (L) 

NicrosD 

格式 化 选项 (0) 


『 | 快速 格式 化 (9Q) 
| | 創建 一 邊 NS-DOS 启动 盘 人》 















































レー テー 人 


Build Output 








compiling sd card.c... 

assembling startup rvmdk.5. 4. 
compiling uartstdio.c. ee 
linking. . . トト 
Program Size: Code=13084 RO-data=176892 RW-data=396 ZI-data=2940 . 
After Build - User command #1: fromelf --bin --output -\rvmdk\sd 7 


".\rvmadkksd_card.axf" | 0 Errors, 0 Warning(s). za 


15-20 sd_card 工程 编译 结果 


15-22 所 示 。 


[| 

ト 

や 
MICROSD (N:) 














大 
新 建文 件 夫 ” 空 文件 夹 | \ 
名 称 ング 修改 日 其 类 型 大 小 村 
pd 3 
』 folders * / 2014/2/2112:05 ”文件 夫 = 
| pictures” 2014/2/2112:05 ”文件 夹 # 





| 2014/2/21 12:22 





























-21 将 microSD 卡 格式 化 成 FAT32 格式 15-22 ”制作 两 个 空 文件 夹 和 一 个 文本 文件 


6) 在 BD - LM4F232 评估 板 与 PuTTY 中 测试 程序 。 
① 将 .axf 文件 下載 到 BD -LM4F232 评估 板 中 。 
② 打开 PuTTY， 在 按 下 板 上 的 重启 按钮 后 ， 如 图 15-23 所 示 。 
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再 coM9 - 











PuTTY Ea 加 





在 PuTTY 中 读 取 SD 卡 
的 文件 系统 








/ 辣 
在 OLED 上 吕 癌 呈 
示 UART 设 置 本 


Cenmect -| 


terminal 


to UARTS. 
115999:N:8: 1 





較 15-23 在 PuTTY 中 读 取 FatFS 





③ 在 提示 符 处 输入 help 命令 ， 如 图 15-24 所 示 。 
④ 输入 ls 命令 显示 卡 中 的 文件 ， 如 图 15-23 所 示 。 

















gp COM9 - PuTTY 

















这 COM9 - PuTTY | 回 屋 : 編 























图 15-24 显示 help 菜单 图 15-25 输入 1s 显示 卡 中 的 文 从 


⑤ 输入 Cat 命令 





为 了 控制 篇 幅 


行 修改 上 述 代 码 增加 
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证 








< 














示 文 本 文件 的 内 容 ， 如 图 15-26 所 示 。 
这 COM9 - PuTTY 


输 错 命 令 时 
的 提示 ! 


输入 正确 时 显示 
的 文件 内 容 ! 





Ex 



































图 15-26 显示 文本 文件 的 内 容 
文件 系统 的 测试 到 此 为 止 ， 有 兴趣 的 读者 可 以 继续 测试 其 他 功能 ， 或 自 
其 他 功能 。 
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基本 图 形 库 (Grlib) 


本 章 将 扼要 介绍 液晶 显示 屏 的 基本 特点 、TivaWare 图 形 库 与 基于 图 形 库 的 应 用 (包括 
介绍 了 OLED 液晶 屏 底层 驱动 程序 的 写法 ) 。 
本 章 的 主要 内 容 : 

> 图 形 库 介绍 

ン TivaWare 图 形 库 简介 

> 例 程 

















g 16.1 图 形 库 与 液晶 屏 概述 


图 形 库 概 述 

TivaWare 图 形 库 是 一 组 免 版 税 的 图 形 基 元 和 小 工具 集 ， 用 于 在 基于 Tiva C 系列 微 处 理 
器 的 具有 图 形 显示 的 电路 板 上 创建 图 形 用 户 界面 。 该 图 形 库 包含 三 个 功能 构建 层 : 显示 屏 驱 
动 器 层 、 图 形 基 元 层 、 小 工具 层 。 

1. 显示 屏 驱 动 器 层 

基于 使 用 中 的 显示 屏 ， 该 层 的 主要 任务 是 完成 下 列 与 显示 硬件 相关 的 低层 接口 程序 : 

1) 显示 相关 的 操作 程序 。 

① 初始化。 

② 背光 控制 。 

③ 対比 度 。 

④ 根据 彩色 图 将 24 位 RGB 值 转换 到 屏幕 上 。 

2) 绘制 图 形 库 程序 。 

① 刷新 。 

② 画 线 。 

③ 画像 素 点 。 

④ 矩 形 绘制 。 

3) 需 用 户 修改 的 硬件 相关 程序 。 

① 将 显示 器 与 TM4 C 器 件 相 连 。 

② 根据 使 用 的 显示 设备 编写 或 修改 现存 的 驱动 程序 (如 颜色 深度 和 大 小 ) 。 
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2. 图 形 基 元 层 

该 层 为 低层 绘图 支持 ， 具 有 以 下 特点 : 

1) 可 绘制 点 、 线 、 和 矩形 、 同 、 字 体 、 位 图 图 形 和 文本 。 

2) 支持 离 屏 缓冲 。 

3) 绘图 上 下 文 的 前 景 和 背景 。 

4) 由 24 位 的 RGB 值 表示 一 种 颜色 (每 色 8 位 ) 。 预 先 定义 150 种 颜色 。 

5) 预先 定义 153 个 基于 现代 计算 机 的 字体 。 

3. 小 工具 层 

它 提 供 复 选 框 、 按 钮 、 单 选 按钮 、 滑 块 、 列 表 框 以 及 一 个 或 多 个 图 像 基 元 的 通用 封装 ， 
以 便 在 显示 屏 上 绘制 用 户 界面 元 素 ， 并 能 够 通过 小 工具 元 素 为 用 户 交 互 提供 应 用 程序 定义 的 
响应 ， 如 图 16-1 所 示 。 














图 1 Introduction 
回 回 2 Display Driver 
g 問 3 Graphics Primitives 
a 划 4 Widget Framework 
3 图 5 Canvas Widget 
3 图 6 Checkbox Widget 
3 图 7 Container Widget 
9 可 8 Image Button Widget 
3 图 9 ListBox Widget 
回 10 keyboard Widget 
3 加 11 Push Button Widget 
3 加 12 Radio Button Widget 
3 加 13 Slider Widget 
回 14 Utilities 
因 15 Predefined Color Reference 
上 16 Font Reference 






































較 16-1 图 形 库 框 架 


为 了 确保 该 软件 易于 理解 和 维护 ，Tiva C 图 形 库 完全 采用 C 语言 编写 ( 除 无 法 实现 的 
以外 ) 。 虽 然 用 C 语言 编写 ， 但 由 于 Cortex - M4 Thumb2 指令 集 的 紧凑 性 ， 该 库 在 存储 和 处 
理 需 使 用 方面 仍然 非常 有 将 。 其 特点 如 下 : 

① 免费 许可 证 和 人 免 版 税 使 用 权 (与 TT ARM Cortex MCU 配合 使 用 ) 。 

② 简化 并 加 快 应 用 程序 的 开发 ， 可 用 于 应 用 程序 开发 或 作为 编程 示例 。 

③ 可 创建 功能 完整 、 易 于 维护 的 代码 。 

完全 利用 Cortex - M4 内 核 的 星 形 中 断 性 能 ， 无 需 任 何 特殊 的 pragma 或 自 定义 汇编 
语言 代码 的 起 始 代码 /结束 代码 功能 。 

⑤ 可 使 用 错误 检查 代码 进行 编译 (用 于 开发 )， 也 可 不 使 用 (用 于 具有 较 小 存储 器 配 
置 的 MCU 中 的 最 终生 产 ) 。 

⑥ 可 作为 对 象 库 和 源 代 码 ， 以 便 按 原样 使 用 该 库 或 根据 需要 修改 。 

Q@ 每 个 外 设 的 完整 源 代码 示例 可 用 于 所 有 Tiva C 开发 和 评估 套件 的 完整 项 目 。 

在 CCS5.x、ARM/Keil、IAR、Code Red、CodeSourcery 以 及 通用 GNU 开发 工具 上 
编译 。 




















液晶 屏 简 介 


目前 在 国内 市 场 上 常见 的 液晶 显示 器 主要 有 两 种 : LCD 和 OLED。 
336 














1. LCD 液晶 显示 器 

① STN - LCD (Super Twisted Nematic) : 超 扭转 向 列 式 液 晶 。 

② LTPS (Low TemperaturePoly Silicon) : 低温 多 唱 硅 。 

③ TFT - LCD (Thin Film Transistor - Liquid Crystal Display) ;薄膜 晶体 管 液晶 显示 器 。 

而 以 TFT - LCD 应 用 最 广泛 ， 它 由 光 导 、 偏 振 片 、 玻 璃 基板 、 储 能 电容 、 源 驱动 (数 
据 )、 门 驱动 、TFT、 公 共 电 极 、 滤 色 片 等 组 成 ,其 特点 是 在 显示 屏 的 每 一 个 像素 点 上 都 有 
一 个 薄膜 晶体 管 ， 使 每 个 像素 都 可 以 通过 脉冲 信号 来 直接 控制 。 可 有 效 克 服 非 选 通 时 的 串 
扰 ， 使 显示 的 图 形 色彩 鲜艳 逼真 。 尽 管 液晶 本 号 并 不 发 光 ， 但 可 通过 对 液晶 施加 不 同 的 电压 
来 改变 液晶 分 子 的 排列 顺序 ， 结 合 偏振 片 与 RGB 彩色 滤 光 片 等 控制 机 构 ， 就 可 将 背光 源 的 
光信 号 〈 包 含 要 显示 图 形 的 信息 ) 打 在 液晶 面板 上 ， 从 而 实现 图 形 的 显示 ， 如 图 16-2 ~ 


16-5 所 示 。 


















































































































图 16-2 TFT-LCD 的 等 效 电 路 


MR 


偏光 片 


图 16-3 TFT 亮度 控制 示意 图 


0 








从 图 16-5 中 可 以 看 到 ， 要 使 TFT - LCD 正常 工作 ,需要 一 个 控制 系统 来 协同 TFT 各 个 
模块 之 间 的 关系 ， 因 此 各 种 控制 芯片 应 运 而 生 。 市 面 上 常用 的 控制 芯片 有 ILI9xxx 系列 ( 比 
如 ILI9320 、ILI9341 等 ) 和 开 公 司 制作 的 开发 板 上 常用 的 SSD2119 等 。 

(1) 数据 显示 格式 

常用 的 数据 显示 格式 有 18BPP 的 RGB666 ( 占 3 个 字 节 ) 与 16BPP 的 RGB565 ( 占 2 个 
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字 节 ) 格式 ， 如 图 16-6 所 示 。 











ーー 彩色 濾 光 片 
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[ar | 
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較 16-4 TFT -LCD 液晶 屏 组 件 示 意 
















HP 数据 驱动 器 
= | i 
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Ea 
TFT-LCD 面 板 『 
得 源 


16-5 TFT -LCD 驱动 框 





s 过 岗 六 省 











器 
器 



































18BPP 数 据 显 示 格 式 


























16 位 数据 总 线 (D[17:13]&D[11:1] 被 用 ) 
图 16-6 TFT -LCD 常用 的 显示 格式 


(2) ILI9320 常用 的 几 个 命令 
① 索引 寄存 器 (IR) ， 如 图 16-7 所 示 。 





R/W RS D15 DI4 DI3 DI2 Dll D10 D9 D8 D7 D6 D5 D4 D3 


-TTT TT TT lms To m 


16-7 索引 寄存 器 











器 
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该 索引 寄存 器 指定 寄存 器 (R00h ~ RFFh) 的 地 址 或 将 要 访问 的 RAM。 
② 开始 振荡 命令 (R00h)， 如 图 16-8 所 示 。 


R/W _ RS DIS DI4 DI3 DI2 Dll D10 D9 D8 D7 D6 D5 D4 D3 


le | ee ee ee 
Oe | 








图 16-8 开始 振荡 寄存 器 








时 ， 将 返回 器 件 型 号 为 “9320”h。 
③ 入 口 模式 命令 (R03h) ， 如 图 16-9 上 部 所 示 。 


R/W _ RS DI5 DI4 D13 D12 Dll D10 D3 D2 


通过 设置 0SC 位 为 “1” 来 启动 内 部 振荡 融 ; 而 设置 “0” 时 停止 振荡 天 工作 。 至 少 等 


待 10 ms 使 振荡 器 的 频率 稳定 后 ， 方 可 进行 其 他 功能 的 设置 。 当 对 该 寄存 器 进行 读 取 操作 


ey Torv] o [ear] o | 0 lmwl o ToroT o oleslkwl 6 oT | 



































和 了 
ID[1:0 モ 00 TID[1:0 モ 00 TD[1:0 ビ 10 TID[1:0 ビ 11 
Horizontal: 遂 減 Horizontal: 遂 増 Horizontal: 通 減 Horizontal: 遂 増 
Vertical: ”递减 Vertical: ”递减 Vertical: ”递增 Vertical: ”递增 
に BF ーー ご | 
AM=0 
水 平 
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图 16-9 入 口 模 式 寄存 器 










从 图 16-9 中 可 看 到 ，AM 用 于 GRAM 更 新 方向 的 控制 。 当 AM = “0” , 水 平 写 方向 的 
地 址 得 到 更 新 ; 而 当 AM =“1” 时 , 垂直 写 方向 的 地 址 得 到 更 新 。 当 用 寄存 器 R16h 和 
R17H 设置 了 一 个 窗口 区 域 ， 仅 基于 1/D[1:0] 的 GRAM 寻 址 区 域 和 AM 置 位 的 区 域 得 到 




















当 更 新 一 个 显示 数据 的 像素 ，LLD[T1:0] 控 制 的 地 址 计数 器 (AC) 会 自动 进 











1 的 操作 ， 详 细 过 程 如 图 16-9 下 部 所 示 。 
④ 显示 控制 1 命令 ， 如 图 16-10 所 示 。 














行 增 1 或 减 


D15 DI4 D13 D4 D3 D2 Dl 


] Lo To lalrroeml oT [essad oT oT loopreleul o [op] 








图 16-10 显示 控制 1 命令 








CL: 用 来 控制 是 8 位 色 , 还 是 262K 色 。 当 CL 为 0 时 262K 色 ， 当 CL 为 1 时 8 位 色 。 


























、DO0 、BASEE 这 3 位 用 于 显示 需 的 关 断 控制 。 当 全 部 置 1 时 打开 显示 ; 当 其 全 0 时 关 断 
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显示 。 可 应 用 该 命令 来 使 能 和 禁止 显示 ， 合 理 使 用 电能 。 
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D[1:0]: 设置 DT11:0] =“11” 来 打开 显示 面板 ; 设置 Di1:0] =“00” 关 闭 显 示 面 板 。 
当 写 D1 =“1” 图 形 将 显示 在 面板 上 ; 而 写 D1 =0 停止 图 形 显示 。 
当 写 D1 =“0” 图 形 显 示 数 据 将 被 保留 在 内 部 GRAM 中 ; 而 当 写 D1 =“1” 时 ，ILI9320 将 



















































































显示 图 形 数 据 。 
当 D1 =“0” 时 ,面板 上 将 不 会 有 显示 ， 所 有 的 源 输 出 将 接地 ， 以 减少 驱动 液晶 时 所 需 
的 充电 /放电 电流 。 











虽然 可 通过 设置 D[1.0] =“01” 来 关闭 显示 ,但 ILI9320 仍 会 继续 进行 内 部 的 显示 操作 。 
而 当 设置 D[1.0] =“00” 时 ， 却 可 以 完全 关闭 显示 器 工作 (这 时 ILI9320 的 内 部 显示 操作 将 
全 部 停止 )。 结 合 GON 与 DTE 位 的 设置 , 可 通过 设置 D[1:0] 来 控制 显示 的 关 / 断 。 

该 命令 CL 位 用 来 控制 是 8 位 色 ， 还 是 262K 色 。 

BASEE: 基本 图 像 显 示 使 能 位 。 当 BASEE =“0” 时 ， 禁 止 基本 图 像 显示 。ILI9320 驱动 
液晶 在 不 点 亮 显示 等 级 或 者 仅 显 示 部 分 图 像 。 当 BASEE = “1 ”时 ， 使 能 基本 图 像 显 示 。D 
[1:0] 设 置 的 优先 级 高 于 BASEE 的 设置 。 

PTDE[1:0] : 部 分 图 像 2 和 部 分 图 像 1 的 使 能 位 。 当 PTDE1/0 =“ 0? 时， 关闭 部 分 图 
像 ， 仅 显示 基本 图 像 ;而 但 PTDE1/0 =“1” 时 , 使 能 部 分 图 像 显 示 ， 且 需 设置 基本 图 像 显示 
使 能 位 为 0 (BASEE =0) 。 

显示 控制 1 命令 中 的 位 与 其 实现 的 功能 或 操作 ， 如 图 16-11 所 示 。 
















































































































































































DO BASEE Source, VCOM Output IL19320 internal operation 


























G1~G320 Gate Output 
VGH 
VGH 
VGL 

正常 显示 











图 16-11 显示 控制 命令 中 的 位 与 其 相应 操作 的 关系 











⑤ CRAM 水 平 / 垂 直 地 址 设置 (R20h，R21h)。AD[16:0] 设 置地 址 计数 器 (AC) 的 初 
始 值 。 址 计数 器 (AC) 可 根据 AM 的 设置 自动 更 新 ，LD 位 作为 被 写 入 到 内 部 CRAM 的 数 
据 。 当 从 内 部 的 GRAM 中 读 取 数据 时 ， 地 址 计数 器 不 会 自动 更 新 。 如 图 16-12 所 示 。 

⑥ 写 数据 到 CRAM 命令 (R22h)， 如 图 16-13 所 示 。 该 寄存 器 是 GRAMd 的 访问 端口 。 
当 通 过 该 寄存 器 更 新 显示 数据 时 ， 地 址 计数 器 (AC) 自动 递增 /递减 。 

@ 水 平和 垂直 RAM 的 地 址 位 置 设置 (R50h、R51h、R52h、R53h)， 如 图 16-14 
所 示 。 
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| 0 |Ap7 | Aps | Aps 
lelololo Ipiel Apil plAps]Apia]Apn 


AD[16:0] GRAM Data Map 


17h00000 ~ 17'h000EF 
17h00100 - 17h001EF 


1line GRAM Data 
ine GRAM Data 





17h00200 ~ 17'h002EF 
17h00300 ~ 17h003EF 


3mdline GRAM Data 
4nline GRAM Data 








17h13D00~ 17'h13DEF 
17'h13E00 ~ 17h13EEF 


318line GRAM Data 
319ine GRAM Data 








17'h13F00 ~ 17'h13FEF 


图 16-12 GRAM 水 平 /垂直 地 址 设置 


320Mine GRAM Data 








R/W RS D17 DI6 DI5 Dl4 D1I3 DI2 Dll DIO D9 D8 D7 D6 D5 D4 D3 D2 Dl DO 


向 RAM 写 入 数据 (WD[17.0]， 在 DB[17:0] 为 每 个 接口 分 配 不 同 的 引 脚 


图 16-13 ” 写 数据 到 GRAM 命令 


D15 DI4 D1I3 D12 DLL DI0 D9 D8 


R/W _RS D7 D6 
Rl 回 回 回 回 回 回 回 還 是 EE 





Ro slslsls ls le |o lvenslvesrlvene [vans|vena vens|vesa [vas ves 


图 16-14 水 平和 垂直 RAM 的 地 址 位 置 设置 



































HSA[7:0]/HEA[7:0]: 水 平方 向 窗口 的 起 始 地 址 和 结束 地 址 。 通 过 设置 HSA 和 HEA 
位 可 调整 写 数据 时 CRAM 水 平 区 域 的 大 小 。 设 置 HSA 和 HEA 位 必须 在 开始 写 RAM 操作 之 
前 进行 ， 且 必须 保证 :“00”h ミ <HSA[7:0] < HEA[7:0] <“EF”h ( 即 239)， 以 及 “04”h ミミ 
HEA -HAS。 

VSA[8:0]/VEA[8:0]: 垂直 方向 窗口 的 起 始 
地 址 和 结束 地 址 。 通 过 设置 VSA 和 VEA 位 可 调整 
写 数据 时 GRAM 垂直 区 域 的 大 小 。 同 样 , 设置 VSA 
和 VEA 位 必须 在 开始 写 RAM 操作 之 前 进行 ， 且 必 
须 保证 : “00”h<VSA[8:0] <VEA[8:0] ミ “13F"h 
( 即 319)。 这 几 个 命令 可 用 于 设置 自 定义 显示 区 域 
的 大 小 ， 如 图 16-15 所 示 。 

2. OLED 液晶 显示 屏 

OLED ( Organic Light - Emitting Diode) 为 有 机 
发 光 二 极 管 液晶 显示 屏 。 其 发 光 原 理 : 当 从 阴极 注 
入 的 电子 和 阳极 注入 的 空 穴 在 电场 力 的 作用 下 ， 这 
两 种 载 流 子 相 向 而 行 ， 在 有 机 材料 中 由 于 相遇 复合 图 16-15 设置 的 显示 区 
而 释放 能 量 ， 从 而 导致 有 机 发 光 材 料 分 子 中 的 原子 核 外 围 的 电子 从 低能 态 跃 迁 
























































VSA 





窗口 地 址 


[Xl 














VEA 


GRAM 地 址 区 














13FEFh 























域 大 小 
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这 些 高 能 电子 返回 低能 态 时 将 会 出 现 发 光 现 象 。 
驱动 OLED 中 的 一 个 像素 点 可 分 为 三 个 阶 ee 


段 : 在 第 1 阶段 ， 段 驱动 首先 把 像素 复位 到 低 a 
电 平 ， 以 便 释 放 存储 在 段 电 极 周边 寄生 电容 中 | | 





先前 数据 的 电荷 ， 并 且 可 通过 命令 (编程 来 
缩短 放电 的 时 间 ; 在 第 2 阶段 ， 段 驱动 把 A、 
B 或 C 色彩 中 的 像素 分 别 预 充电 到 所 需 的 电 平 
值 VPA、VPB 和 VPC， 同 样 可 通过 命令 ( 编 OLED 
程 ) 来 缩短 充电 的 时 间 ， 最 后 阶段 是 电流 驱动 | 思拓 的 行 1 bp 

段 驱动 


阶段 ,采用 PWM 方式 ， 通 过 段 驱动 中 的 电流 二 | 
源 给 像素 点 提供 恒定 的 驱动 电流 。OLED 段 和 Ra 


公共 驱 动 模块 框 图 与 驱 动 信号 波形 分 别 如 图 16-16 OLED 段 和 公共 驱动 模块 框图 
图 16-16、16-17 所 示 。 








上 电流 驱动 





| 未 选择 行 ] 














上 复位 


















































帧 周期 未 选中 行 


Com 0 一 -一 一 一 一 の 
Vcowm ーー ーー ーー 
w 日 HM a 
Com 1 选中 的 行 


“UU 











公共 电压 人 i | 
1 1 1 
VcoMH 1 
1 Time 
Vss ゴ i ! ーー 
1 | 1 
段 电压 4 | VpAVpp Vpc | 
1 1 
| ジジ Waveform for ON | 
1 
for OFRI | Time 
Vss + = 








較 16-17 上段 和 公共 驱动 信号 的 波形 


在 图 16-16 与 16-17 中 可 以 看 到 ， 段 驱动 器 有 288 (96 x3) 个 电流 源 驱 动 OLED 面板 
(选用 96 x64 OLED ) 。 通 过 对 比 度 设 置 命令 ， 可 将 驱动 电流 在 0 ~200 pA 内 进行 调整 ， 总 共 
256 级 。 公 共 驱 动 器 会 产生 电压 扫描 脉冲 ， 并 进行 逐 行 顺序 扫描 。 如 果 没 有 行 被 选中 ， 该 行 
的 所 有 像素 将 被 驱动 到 电压 VCOMH 的 反 相 偏 置 ， 在 扫描 行 时 ， 该 行 的 所 有 像素 可 通过 发 送 
相应 的 数据 信号 到 对 应 段 引 脚 来 打开 或 关闭 这 些 像素 点 。 如 果 该 像素 点 被 关闭 ， 段 驱动 电流 
将 保持 0 电 平 。 反 之 ， 该 像素 点 打开 ， 段 驱动 电流 为 sec。 

(1) OLED 的 主要 优点 

其 主要 优点 有 质 轻 、 厚 度 薄 、 可 弯曲 、 省 电 、 自 发 光 、 对 比 度 较 高 、 视 角 广 、 反 应 速度 
快 等 。 由 于 OLED 比 TFT -LCD 屏 性 能 更 为 优越 ， 已 广泛 地 应 用 于 各 种 电子 产品 中 。 下 面 将 
介绍 由 SSD1332 控制 芯片 和 96 x64 面板 组 成 的 OLED 液晶 。 

(2) SSD1332 控制 芯片 的 模块 框图 

SSD1332 控制 芯片 的 模块 框图 如 图 16-18 所 示 。 
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Command 
Decoder 


Display 
Timing 
Generator 


DC-DC voltage 
convertcr 


SEG/COM OLED 
Driving block 





图 16-18 SSD1332 控制 芯片 的 模块 框图 


(3) 通信 方式 采用 串 行 (SPI) 模式 




































































其 时 序 如 图 16-19 所 示 。 图 中 信息 描述 见 表 16-1。 
表 16-1 图 中 信号 描述 
信号 名 称 描 人 迷 信号 名 称 描 述 
D/C# 数据 /命令 标志 (0: 命令 ; 1: 数据 ) CS# 片 选 信号 
SCLK (Do) 串 行 时 钟 线 SDIN ( D, ) 串 行 数据 线 
as 时 钟 周 期 tpsw 写 数据 建立 时 间 
tg 地 址 建立 时 间 tpHW 写 数据 保持 时 间 
tAH 地 址 保持 时 间 tcrkr 时 钟 低 电 平时 间 
tcss 片 选 建立 时 间 tcrkn 时 钟 高 电 平时 间 
test 片 选 保持 时 间 th 上 升 时 间 
ty 下 降 时 间 














从 图 16-19 中 可 以 看 到 ， 当 CS# 为 低 电 平时 ， 将 使 能 SSD1332 控制 需 。 在 每 个 SCLK 号 
的 上 井 沿 , SDIN 上 的 数据 会 以 D7 、D6…… D0 的 次 序 移入 到 8 位 移 位 寄存 器 中 。 每 8 个 时 
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钟 周期 采样 1 次 ， 如 果 DZC# 信 号 置 高 电 平 ， 则 移 位 寄存 器 中 的 数据 将 会 写 和 人 CDDRAM, 如 
果 DZC# 信 号 置 低 电 平 ， 则 移 位 寄存 器 中 的 数据 将 会 写 人 指令 寄存 需 


= ミミ ce ミュ 
tas tAH 






































CS# tcss tcsH 

| t toycle t 
|< CLKL CLKH 

SCLKDy) 

全 tk 
| 一 一 一 
tbsw tpmw 
忆 == 
SDINOD) 4 Valid Data 醒 罗 > 
CS# 
SCLKDy) 





sp < Xr 2 く ps うく mp ps Xn く pe > 


图 16-19 串 行 接口 的 时 序 图 




















(4) 图 形 显示 数据 RAM (CDDRAM ) 

GDDRAM 为 要 显示 图 形 的 位 映射 静态 RAM 保存 , 其 大 小 96 x 64 x 16 位 ， 且 操作 灵 
活 ， 可 通过 软件 来 实现 段 和 公共 输出 的 重 映射 。 

对 于 显示 的 垂直 滚动 ， 内 部 寄存 器 存储 显示 的 起 始 行 可 以 被 设置 成 控制 RAM 数据 的 部 
分 被 映射 到 显示 。 每 个 像素 点 具有 16 位 的 数据 ， 颜 色 A、B 和 C 三 个 子 像素 分 别 为 6 位 、5 
位 和 6 位 。 数 据 像素 的 图 形 显示 数据 RAM 结构 如 图 16-20 所 示 。 
















































































LU Pt : 



























































段 給 出 |SA0|SBO| SCo| SAl| SB1| SC1| SA2| SB2| SC2| : Ag3sB93|sc93SA94RB94SC94RA9ssB9slscgs 


图 16-20 65K 色彩 深度 图 形 显示 数据 RAM 结构 
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发 送 一 个 16 位 数据 的 像素 被 分 成 两 个 8 位 数据 的 传输 ， 如 图 16-21 所 示 。 


C2 





























图 16-21 6SK 色彩 深度 图 形 显示 数据 写 人 序列 
在 256 色 模 式 中 ， 每 个 像素 由 8 位 构成 。 颜 色 A 用 2 位 表示 ， 而 颜色 B 和 C 由 3 位 表 


示 。 虽 然 只 用 8 位 来 表示 一 个 像素 ,但 每 个 像素 在 内 部 图 形 显示 数据 RAM 中 却 要 占用 16 位 
存储 空间 ， 其 格式 如 图 16-22 所 示 。 















































C RAW B| RAM 
(3 bits) (3 bits) | 内 容 
(5 bits) (6 bits) 





000 00000 000 000000 



























001 00100 001 001000 01000 
010 01000 010 010000 

011 01100 011 011000 11 11100 
100 10010 100 100100 

101 10110 101 101100 565RGB 

110 11010 110 110100 








| 
10 10100 | ， 











111 11110 111 111100 


图 16-22 一 个 像素 256 色 深 度 的 网 形 显示 数据 RAM 结构 
(5) OLED 的 几 个 常用 命令 












































OLED 的 几 个 常用 命令 的 功能 介绍 见 表 16-2。 
表 16-2 几 个 常用 命令 的 功能 介绍 (MCU 接口 引 脚 设 置 为 D/C =0、R/W( WR#) =0、E(RD#) =1) 
D/C Hex D7 | D6 | D5 | D4 | D3 | D2 | D1 | D0 命令 描述 
a a 
1 se se sa 人 复 企 
0 A[6:0] | * |A6|IAS|A41A3|1A21A1|AO 设置 列 地 址 ー i i 
0 | B[6:0] | * |B6|B5 | B4|IB3|B2 BI | BO | 
a ラー ws J 外 们 
0 25 ilililaglilali A 复位 
0 A[5:0] | | * |ASIA4 A3|A2|Al|AO 设置 行 地 址 Jr ga メー クト 0 信访 
B[5.0] | x | * |Bs Ba B3lp2 Bl no EAA 复位 
设置 颜色 A 的 对 双 字 节 命 令 从 1 ~ 256 个 对 比 度 步 长 
0 81 1pAg0l0|0|0|90|1| 比 度 可 选 
0 A[7:0] | A7 A5 A4 |A3|A2 Al | AO ( 段 引 脚 : SAO 对 比 度 随 步 数 的 增加 而 增 大 ， 复 位 = 
~ SA95 ) 80h 
设置 颜色 B 的 对 双 字 节 命 令 从 1 ~ 256 个 对 比 度 步 长 
0 | 62 |1|10|10|10|10|10|1|0O| 比 度 可 选 
0 A[7:0] |A7 |A6|A5|A41A3|A21Al|A0 ( 段 引 脚 : SBO 对 比 度 随 步 数 的 增加 而 增 大 ， 复 位 = 
~ SB95 ) 80h 
设置 颜色 C 的 对 双 字 节 命 令 从 1 ~ 256 个 对 比 度 步 长 
0 | 83 |110|10|10|10|0|1|1| 比 度 可 选 
0 | A[7:0 ] |A7|A6|A5 1A41A31A21A11AO ( 段 引 脚 : SCO 対比 度 随 歩数 的 増加 面 増大 , 食 位 = 
~ SC95) 80h 
设置 A[3:0] 从 0000，0001… 到 1111 
0 A[3:0] |* |* |*|*|A31A21A1IAO 主 电流 控制 来 调节 主 电流 衰减 因子 从 1/16，2/16… 
到 16/16。 复 位 =1111b， 无 衰减 
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( 续 ) 


D/C Hex D7 | De | D5 | D4 | D3 | D2 | D1 DO 命 令 描 述 





A[0] =0, 水 平地 址 增 量 (复位 ) 
A[0] =1, 垂 南 地 坪 増 量 
A[1] 多 
) 




















也 址 0 映射 到 SEG0 ( 复 

















位 
A[1] =1， 列 地 址 95 映射 到 SECO 列 
地 址 
0 AO 1|0|1loO|O|OloOlOl| 设置 重 映射 和 数 a 
0 A[7:0] 1A7|A6|AS|A4 | * | * |A1|AO| 据 格式 


A[4] =1, 从 COM (n -1) 扫描 到 
COM0 。 as 
[5] =0， 禁 止 把 COM 拆 分 成 奇偶 











[5] =1, 使 能 把 COM 拆 分 成 奇偶 
[7:6] 256 彩色 格式 
01; 65 k 彩色 格式 (复位 ) 

















设置 GRAM 的 显示 起 始 行 寄 存 吕 
设置 显示 起 始 行 从 0 -63 
显示 起 始 行 寄存 器 复位 后 重 置 为 00h 























0 A2 110|11010|10O|1lO 设置 显示 偏 移 星 由 COM 设置 从 0 -63 垂直 滚动 
0 | A[5:0] | x |* |A5|A41A3|A2|AI|AO| “EE 该 值 复 位 后 重 置 为 00h 








A4h = 正常 显示 (复位 ) 

A5h = 开启 全 屏 显 示 ， 所 有 像素 在 GS 
= 63 级 

0 A4~A7 |110|111010|111X1lXO 设置 显示 模式 A6h = 关闭 全 屏 显 示 ， 关闭 所 有 的 
像素 
A7h = 闭 显 示 











AE ~ yk AEh = 显示 关闭 (复位 ) 
0 i 110|11101X3|111|1 显示 开 / 关 AFh - 打开 显示 






































ee 幅 ， 本 小 节 仅 就 图 
形 库 作 一 扼要 介绍 ， 并 对 几 个 常用 库 函 数 的 功能 进行 说 明 。 


图 形 库 的 特点 


(1) 主要 特点 

1) 免费 许可 证 和 免 版 税 使 用 权 (与 Tiva C MCU 配合 使 用 ) 。 

2) 简化 并 加 快 应 用 程序 的 开发 ， 可 用 于 应 用 程序 开发 或 作为 编程 示例 。 

3) 可 创建 功能 完整 、 易 于 维护 的 代码 。 

4) Tiva 图 形 库 完全 采用 C 语言 编写 (除了 不 可 能 实现 的 例外 )。 

$) 完全 利用 Cortex - M4 内 核 的 中 断 性 能 , 元 需 任 何 特殊 的 progma 或 自 定义 汇编 起 始 代 
码 / 结 束 代 码 功能 。 

6) 既 可 使 用 错误 检查 代码 进行 编译 (用 于 开发 ) ， 也 可 不 使 用 (用 于 具有 和 较 小 存储 器 
346 











配置 的 MCU 中 的 最 终生 产 ) 。 

7) 可 作为 对 象 库 和 源 代码 ， 以 便 按 原样 使 用 图 形 库 或 根据 需要 进行 修改 。 

8) 每 个 外 设 的 完整 源 代码 示例 可 用 于 所 有 Tiva 开发 和 评估 套件 的 完整 项 目 。 

9) 可 在 CCS4/5/6 、 ARM/Keil 、IAR 、Code Red 、CodeSourcery 以 及 通用 CNU 开发 工具 
上 编译 所 建立 的 图 形 库 工 程 。 

(2) 特殊 工具 (utilities) 

下 列 工 具 用 于 产生 与 图 形 库 兼容 的 数据 结构 。 

1 ) ftrasterize。 

① 使用 rreeType 字体 字体 浑 染 包 将 自 定义 字体 转换 成 图 形 库 格式 。 

② 支持 的 字体 包括 : OpenType 字体 的 TrueType@ 、PostScriptPType 1 和 Windows®FNT。 

2) Imi - button。 使 用 脚本 捕 件 GIMP 创建 自 定义 形状 按钮 。 产 生 的 图 像 可 用 于 按钮 
控件 。 

3) pnmtoc。 

① 将 NetPBM 图 像 文件 转换 成 一 个 图 形 库 兼 容 的 文件 格式 。 

② NetPBM 图 像 格式 可 由 CIMP 、NetPBM 、ImageMajik 等 产生 。 


图 形 库 源 代码 
表 16-3 是 图 形 库 源 代码 的 组 织 概述 及 各 部 分 的 功能 简介 。 


表 16-3 源 代码 简介 


















































































































































程序 名 称 功能 描述 
Makefile 构建 图 形 库 的 规则 
canvas. C 画布 的 源 代码 
canvas. h 画布 的 头 文件 
ccs/ Code ComposerStudio 工程 文件 目录 
charmap. c 程序 代码 页 映射 函数 的 源 代码 
checkbox. c 复 选 框 的 源 代码 
checkbox. h 复 选 框 的 头 文件 
circle. c 圆 基 元 的 源 代码 
container c 容器 控件 的 源 代 码 
container h 容器 控件 的 头 文件 
context c 绘图 上 下 文 的 源 代码 
fonts/ 图 形 库 提供 的 包含 字体 结构 的 字体 源 文 件 
frasterize/ trasterize 程序 的 源 代码 
grlib. Opt 于 构建 图 形 库 的 KeiluVision 工程 选项 文件 
grlib. Uv2 于 构建 图 形 库 的 KeiluVision 工程 文件 
grlib. ewd 于 构建 图 形 库 的 IAR Embedded Workbench 工程 选项 文件 
grlib. ewp 于 构建 图 形 库 的 LAR Embedded Workbench 工程 文件 
grlib. h 包含 基本 图 形 原 型 的 头 文件 
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程序 名 称 功能 描述 
image. c 基本 图 形 的 源 代码 
line. c 线 基 元 的 源 代码 
offscrl bpp. c 1BPP 离 屏 缓冲 显示 驱动 程序 源 代码 
offscr4bpp. c 4BPP 离 屏 缓冲 显示 驱动 程序 的 源 代码 
offscr8bpp. c 8BPP 离 屏 缓冲 显示 驱动 程序 的 源 代码 
pumtoc/ pnmtoc 程序 的 源 代码 
pushbutton. c 按钮 控件 的 源 代码 
pushbutton. h 按钮 控件 的 头 文件 
radiobutton. c 单 选 按钮 的 源 代码 
radiobutton. h 单 选 按钮 的 头 文件 
readme. txt 图 形 库 高 亮 的 简短 描述 文件 
rectangle. c 和 矩形 基 元 的 源 代码 
shider. c 滑动 控件 的 源 代码 
slider. h 滑动 控件 的 头 文件 
string c 字符 串 基 元 的 源 代码 
widget c 控件 框架 的 源 代码 
widget. h 包含 控件 框架 原型 的 头 文件 

图 形 固件 库 函 数 


1. 显示 驱动 库 





(1) 显示 驱动 库 概述 














[=| 














示 控 制 器 进行 通信 和 理解 显示 




















控制 器 所 





显示 驱动 用 于 图 形 库 与 特定 显示 器 的 接口 。 它 负责 处 理 有 关 显 示 的 底层 细节 ， 包 括 与 








[= 





\ 














需 命令 的 行为 。 





[=| 








ン 











行 与 








显示 操作 有 关 的 例 程 。 显 
































示 驱 动 程序 必须 提供 两 件 事 情 ; 通过 图 形 库 将 所 需 程序 集 绘制 到 屏幕 上 和 一 组 用 于 执 
示 相 关 的 操作 会 根据 不 同 显示 咒 有 所 不 同 ， 但 都 包含 初始 化 程 
序 ， 并 可 能 包括 诸如 背光 控制 和 对 比 度 控制 。 


由 图 形 库 所 需 的 例 程 组 成 的 一 个 结构 体 来 描述 图 形 库 的 显示 驱动 程序 。tDisplay 结构 体 











[= 











包含 这 些 函 数 指针 ， 以 及 屏幕 的 宽度 和 高 度 。 显 示 驱 动 程序 提供 了 这 种 结构 的 实例 ， 以 及 在 


特定 
































显示 驱动 程序 的 头 文件 中 定义 该 结构 体 的 原型 。 
对 于 一 些 显示 器 ， 它 可 能 在 本 地 存储 器 的 组 种 区 中 绘制 更 有 效 ， 并 在 所 有 的 绘图 操作 完 
成 后 将 结果 复制 到 屏幕 上 。 这 就 是 常用 的 4BPP 真 彩 显示 





























， 其 中 在 显示 存储 器 中 的 每 个 字 节 


有 2 个 像素 。 在 这 种 情况 下 ，Flush ( ) 操作 用 于 指示 应 该 被 复制 到 显示 器 上 的 本 地 显示 组 


冲 区 
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(2) tDisplay 结构 体 定 义 














该 结构 体 定 义 了 与 显示 驱动 有 关 的 变量 和 参数 ， 见 表 16-4。 


表 16-4 tDisplay 

































































定义 typedef struct 
| 
int32_t 132Size; 
void  *pvDisplayData: 
uint16_t uil6 Width; 
uintl6_t uil6Height; 
void ( * pfnPixelDraw) (void * pvDisplayData , 
int32_ti32X, 
int32_ti32Y ， 
uint32_t ni32Value ) ; 
void ( * pfnPixelDrawMuliple )(void * pyDisplayData , 
int32 ti32X , 
int32_t i32Y, 
int32_t i32X0 , 
int32_t i32Count, 
int32_t i32BPP, 
const uint8_t * pui8 Data, 
const uint8_t * pui8 Palette ) ; 
void ( * pfnLineDrawH ) (void * pvDisplayData , 
int32_t i32X1 , 
int32_t 132X2 , 
int32_t i32Y ， 
uint32_t ui32 Value ) ; 
void ( * pfnLineDrawV ) (void * pvDisplayData , 
int32_t i32X , 
int32_t i32Y1 , 
int32_t i32Y2 , 
uint32_t ui32 Value)) ; 
void ( * pfnRectFill ) (void * pyDisplayData , 
const tRectangle * psRect, 
uint32_t ui32 Value ) ; 
uint32_t ( *pfnColorTranslate ) ( void * pyDisplayData , 
uint32_t ui32 Value ) ; 
void ( * pfnFlush) (void * pyDisplayData ) ; 
1 
| 
tDisplay 
成 员 描 述 
132Size 结构 体 的 大 小 
vDisplayData 指向 特定 显示 驱动 数据 的 指针 
uil6Width 显示 宽度 
uil6Height 显示 高 度 
fnPixelDraw 指向 在 显示 设备 上 画 点 的 函数 指针 
pfnPixelDrawMultiple 指向 在 显示 设备 上 夯 多 点 的 函数 指针 
fnLineDrawH 指向 在 显示 设备 上 绘制 水 平 线 的 函数 指针 
pfnLineDrawV 指向 在 显示 设备 上 绘制 垂直 线 的 函数 指针 
fnRectFill 指向 显示 设备 上 绘制 填充 型 矩形 的 函数 指针 
pfnColorTranslate 指向 将 24 位 RGB 颜色 转换 成 特定 显示 颜色 函数 的 指针 
pfnFlush 指向 在 显示 设备 上 刷新 任何 绘图 操作 缓存 的 函数 指针 
功能 描述 该 结构 体 定义 了 显示 驱动 的 特性 











例如 ， 在 Tiva TM4C123G 开发 板 中 ,采用 CFA19664 -F - B1 OLED 和 SSD1332 控制 芯 
片 液晶 屏 的 tDisplay 结构 体 的 定义 如 下 : 


const tDisplay g_sCFAL96x64x16 = 
| 
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sizeof(tDisplay ) ， // 结 构 体 的 大 小 











0, // 没 有 用 到 特定 数据 ,这 里 为 空 

96 ， // 显 示 宽 度 

64, // 显 示 高 度 

CFAL96x64x16PixelDraw, // 画 点 

CFAL96x64x16PixelDrawMuliple , // 画 多 点 

CFAL96x64x16LineDrawH , // 绘 制 水 平 线 

CFAL96x64x16LineDrawV , // 绘 制 垂直 线 

CFAL96x64x16RectFil ， // 绘 制 填充 型 矩形 
CFAL96x64x16ColorTranslate , // 将 24 位 RGB 颜色 转换 成 特定 显示 颜色 
CFAL96x64x16Flush // 刷 新 任何 绘图 操作 缓存 





人 
在 这 个 结构 体 中 定义 了 OLED 屏 的 色彩 数据 为 16BPP， 显 示 区 大 小 (96( 宽 ) x64( 高 ) ) ， 
以 及 调用 了 基本 的 图 形 绘 制 函 数 。 
(3) 显示 驱动 所 使 用 的 固件 库 孙 数 介绍 
① ColorTranslate 哨 数 ， 见 表 16-5。 


























表 16-5 ColorTranslate 













































































功能 将 24 位 的 RGB 颜色 转换 成 显示 驱动 特定 的 颜色 

函数 原型 int32_t ColorTranslate( void * pvDisplayData, uint32_t ui32Value) 

输入 参数 描述 

pvDisplayData 指向 特定 显示 驱动 数据 的 指针 

ui32Value 24 位 RGB 颜色 

功能 描述 该 函数 用 于 把 24 位 的 RGB 颜色 的 值 转换 成 可 被 写 人 到 显示 帧 缓冲 区 来 再 现 该 颜色 的 值 
返回 参数 返回 显示 驱动 程序 特定 的 颜色 

















② Flush 函数 ， 见 表 16-6。 











表 16-6 Flush 
功能 刷新 任何 缓存 的 绘制 操作 
函数 原型 void Flush (void * pvDisplayData) 
输入 参数 描述 
pvDisplayData 指向 特定 显示 驱动 数据 的 指针 














这 个 函数 刷新 任何 绘图 操作 显示 缓存 。 这 有 利于 本 地 帧 缓冲 区 用 于 绘图 操作 ， 以 及 刷新 
将 复制 到 显示 器 的 本 地 帧 缓冲 区 。 如 果 没 有 缓存 操作 的 显示 驱动 ， 此 函数 可 以 为 空 














功能 描述 





返回 参数 无 








③ LineDrawH 函数 ， 见 表 16-7。 
表 16-7 LineDrawH 


功能 绘制 一 条 水 平 线 








void LineDrawH(void * pvDisplayData , 


i32X1 , 
函数 原型 i32X2, 
i32Y, 





Uint_32 ui32 Value ) 
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输入 参数 描述 

pvDisplayData 指向 特定 显示 驱动 数据 的 指针 

i32X1 线 的 X 起 始 坐标 

i32X2 线 的 X 结束 坐标 

i32Y 线 的 了 坐标 

ui32 Value 线 的 颜色 

功能 描述 该 函数 在 显示 器 上 绘制 一 条 水 平 线 ， 假 设 线 的 坐标 在 显示 器 的 范围 之 内 
返回 参数 无 








由 LineDrawV 糸数 , 見 表 16-8。 
表 16-8 LineDrawV 





























功能 绘制 一 条 垂直 线 
void LineDrawH (void * pvDisplayData , 
ij32 Y1 , 
函数 原型 132 Y2 , 
132X 


Uint_32 um32 Value ) d long ulValue ) 






































输入 参数 描述 

pvDisplayData 指向 特定 显示 驱动 数据 的 指针 

i32X1 线 的 Y 起 始 坐 标 

i32X2 线 的 了 结束 坐标 

i32Y 线 的 X 坐标 

ui32Value 线 的 颜色 

功能 描述 该 函数 在 显示 器 上 绘制 一 条 垂直 线 ， 假 设 线 的 坐标 在 显示 器 的 范围 之 内 
返回 参数 无 








⑤ PixelDraw 函数 ， 见 表 16-9。 


表 16-9 PixelDraw 






































功能 在 屏幕 上 绘制 一 个 像素 点 
void PixelDraw( void * pvDisplayData , 

82X ， 

函数 原型 32Y, 
Uint_t ui32 Value ) 

答 入 参 数 指 述 
pvDisplayData 指向 特定 显示 驱动 数据 的 指针 
i32X 像素 点 的 X 坐标 
i32Y 象 素 点 的 Y 坐标 
ui32Value 像素 的 颜色 
功能 描述 该 函数 设置 给 定 像素 为 一 个 特定 颜色 
返回 参数 无 


⑥ PixelDraw 函数 ， 见 表 16-10。 
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表 16-10 PixelDraw 





























功能 在 屏幕 上 绘制 一 个 像素 点 
void PixelDraw( void * pvDisplayData, 

函数 原型 132X , 

a 132Y , 

Uint_t ui32 Value ) 

输入 参数 描述 
pvDisplayData 指向 特定 显示 驱动 数据 的 指针 
i32X 像素 点 的 X 坐标 
32iY 像素 点 的 了 坐标 
ui32Value 像素 的 颜色 
功能 描述 该 函数 设置 给 定 像素 为 一 个 特定 颜色 
返回 参数 无 








⑦ PixelDrawMuliple p 








函数 ， 见 表 16-11 。 


表 16-11 PixelDrawMultiple 


























































































































功能 在 屏幕 上 绘制 水 平 像素 点 
void PixelDraw Muliple (void * pvDisplayData , 
i32X, 
i32Y, 
0 i32X0, 
函数 原型 132Count, 
i32BPP, 
Const uint8_t * pi8Data, 
Const uintg t *) 
输入 参数 描述 
pvDisplayData 指向 特定 显示 驱动 数据 的 指针 
i32X 第 一 个 像素 点 的 X 坐标 
i32Y 第 一 个 像素 点 的 Y 坐标 
i32X0 子 像素 在 像素 数据 内 的 偏 移 量 ， 在 每 像素 格式 1 或 4 位 格式 中 的 子 像素 偏 移 量 是 有 效 的 
132Count 待 绘制 的 像素 点 数目 
i32BPP 每 像素 的 位 数 ， 其 必须 为 1、4 或 8 
pi8Data 指向 像素 数据 的 指针 
pi8Palette 指向 用 于 绘制 像素 调 色 板 的 指针 
功能 描述 该 函数 使 用 提供 的 调 色 板 在 屏幕 上 绘制 水 平 像素 点 
返回 参数 无 





RectFill 函数 ， 见 表 16-12。 


表 16-12 RectFill 

















功能 填充 矩形 
void RectFill(void * pvDisplayData, 
函数 原型 const tRectangle *pRect, 
uint32_t ui32 Value ) 
输入 参数 描述 
pvDisplayData 指向 特定 显示 驱动 数据 的 指针 
pRect 指向 描述 矩形 结构 体 的 指针 
32uiValue 和 矩形 的 颜色 
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功能 描述 该 函数 在 显示 如 上 填充 一 个 矩形 
返回 参数 无 





(4) OELD 液晶 屏 驱 动 程序 片段 解读 
下 面 将 对 TI 提供 的 CFAL96x64 OLED 液晶 屏 的 驱动 程序 片段 作 一 比较 详细 的 介绍 。 
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// 定 义 所 使 用 的 SSI 外 设 和 数据 速率 


// ネネ ボネ ネネ ポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ボボ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ネネ ポポ 














#define DISPLAY_SSI_BASE SSI2_BASE //SSI2 
#define DISPLAY_SSI_CLOCK 4000000 


ンク キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ エキ キキ キキ キ キキ キキ キキ: 
// 定 义 显示 数据 /命令 (DZ C) 信号 的 端口 和 引 脚 

ンク 人 キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ 
#define DISPLAY_D_C_PORT GPIO_PORTH_BASE 

#define DISPLAY_D_C_PIN GPIO_PIN_6 





// 当 初始 化 时 发 送 给 显示 器 的 命令 数组 


static 





uint8_t g_ui8DisplayInitCommands| ] = 


| 














// OxAE, //0xAE 是 命令 表 中 的 关闭 显示 命令 ( 见 表 16-2) 
0x87 ,0x07 ， //0x87 命令 表 中 主 控制 电流 的 衰减 因子 (因子 =7/16) 
0x81,0xA0, //0x81 命令 表 中 对 比 度 控制 A 命令 , 共 256 级 ,这 里 为 160 
0x82 ,0x60， //0x82 命令 表 中 对 比 度 控 制 B 命令 , 共 256 级 ,这 里 为 96 
0x83 ,0xB0 , //0x83 命令 表 中 对 比 度 控制 C 命令 , 共 256 级 ,这 里 为 176 
0xA0,0x20, //0xA0 重新 映射 和 数据 格式 命令 ,“00” 表 示 使 用 8BPP 色彩 模式 
0x26 ,0x01 , //0x26 填充 使 能 /禁止 命令 ,0x01 为 矩形 填充 使 能 
OxAF //0xAF 为 打开 显示 命令 


}; 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 玉米 米 玉米 米 米 米 米 米 
//! 向 显示 控制 器 写 人 一 组 指令 字 节 

//! 参数 pi8Cmd 是 指向 一 组 命令 字 节 的 指针 

//! 参数 ui32Count 是 命令 的 字 节 数 

//! 此 函数 提供 了 一 种 发 送 多 个 命令 字 节 到 显示 控制 器 的 方法 

//! 它 可 以 用 于 单个 指令 或 多 个 命令 在 缓冲 器 中 链接 一 起 

//! 它 会 等 待 任何 以 前 的 操作 完成 ,然后 把 所 有 的 命令 字 节 复制 到 控制 器 中 

//! 直到 最 后 一 个 命令 字 节 被 写 人 到 SSI 的 FIFO 中 时 , 它 才 会 返回 。 但 当 该 函数 返回 时 

//! 数据 仍然 可 以 被 移出 到 显示 控制 右 


// ネネ ボボ ポ ネ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ポポ ボネ ポポ 




















static void 


CFAL96x64x16WriteCommand( const uint8_t * pi8Cmd , uint32_t ui32Count ) 


| 
( 


// 
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// 等 待 以 前 的 操作 完成 

// 

while( ROM_SSIBusy( DISPLAY_SSI_BASE) ) 
| 

| 





// 

// 将 D/C 引 脚 的 电 平 拉 低 来 指示 是 写 命令 

// 

ROM_CPIOPinWrite( DISPLAY_D_C_PORT, DISPLAY_D_C_PIN ,0) ; 
// 

// 向 显示 器 发 送 所 有 命令 字 节 

// 


while( ui32Count -- ) 


| 
ROM_SSIDataPut( DISPLAY_SSI_BASE, * pi8Cmd ) ; 
pi8Cmd ++ ; 


ノノ 类 洲 洲 米 米 米 米 米 米 米 米 炒米 炒米 炒米 炒米 米 米 炒米 米 米 炒米 炒米 米 玉米 玉米 玉米 炒米 米 米 米 米 米 米 炒米 米 米 炒米 米 玉米 玉米 炒米 炒米 炒米 炒米 米 米 米 米 米 米 米 米 米 炒 
//! 向 显示 控制 器 写 和 人 一 组 数据 字 节 

ノノ 类 沙洲 米 米 米 炒米 米 玉米 炒米 炒米 炒米 炒米 炒米 炒米 米 米 米 米 米 米 米 玉米 玉米 炒米 炒米 米 米 米 米 炒米 炒米 炒米 米 米 米 玉米 炒米 炒米 炒米 炒米 炒米 米 米 米 米 米 米 米 米 米 炒 
static void 

CFAL96x64x16 WriteData( const uint8_t * pi8Data,uint32_t ui32Count ) 

| 


// 
// 等 待 以 前 的 操作 完成 
/ 


while(ROM_SSIBusy( DISPLAY_SSI_BASE ) ) 
| 
| 




















// 
// 将 D/C 引 脚 置 为 高 电 平 来 指示 是 写 数据 
// 


ROM_GPIOPinWrite( DISPLAY_D_C_PORT, DISPLAY_D_C_PIN, DISPLAY_D_C_PIN) ; 


シタ 
/向 显示 需 发 送 所 有 数据 字 节 
while( ui32Count 一 - ) 


| 
ROM_SSIDataPut( DISPLAY_SSI_BASE, * pi8Data) ; 
pi8Data ++ ; 


// ネネ ボネ ネネ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ネネ ポポ 
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//! 在 屏幕 上 绘制 一 个 像素 点 


// ネネ ポポ ネネ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボネ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ネネ ポポ 


static void 
CFAL96x64x16PixelDraw( void * pvDisplayData ,int32_t i32X ,int32_t 132Y, 
uint32_t ui32 Value ) 


uint8_t ui8Cmd[ 8 | ; 


// 
// 加 载 列 命 令 , 开 始 和 结束 列 

// 

m8Cmd[0] =0x15; //0x15 是 列 地 址 设置 命令 ( 见 表 16-2) 





ui8Cmd[1] = (uint8_t)i32X;”// 开 始 列 
ui8Cmd[2] =(uint8_Di32X: /结束 列 





// 
// 加 载 行 命令 ,开始 和 结束 行 

// 

ui8Cmd[ 3] =0x75; //0x75 是 行 地 址 设置 命令 ( 见 表 16-2) 


ui8Cmd[4] = (uint8_t)i32Y;”// 开 始 行 
ui8Cmd[5] = (uint8_t)i32Y;”// 结 束 行 

















/ 
// 把 数组 mi8Cmd[8] 的 前 6 个 元 素 送 给 显示 , 即 送行 、 列 命令 给 显示 
// 


CFAL96x64x16WriteCommand( ui8Cmd ,6 ) ; 


KS 

// 把 表示 像素 的 数据 值 发 送 到 显示 带 

// 

CFAL96x64x16WriteData( (uint8_t * ) き ui32 Value,1 ) ; 








// 米 米 米 米 炒米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 
iii YY E EL 
//1 画 水 平 线段 


// ネネ ポポ ネネ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ポポ ネネ ポポ 





static void 
CFAL96x64x16LineDrawH( void * pvDisplayData , int32_t i32X1 ,int32_t i32X2, 
int32_ t 132Y ,uint32_t ui32 Value ) 


uint8_t ui8LineBuf| 16 ] ; 


unsigned int uldx; 





// 
// 发 送行 、 列 的 起 始 和 结束 地 址 

// 

u8LineBuf[ 0] =0x15; //0x15 是 列 地 址 设置 命令 
ui8LineBuf[ 1 ] =i32X1 <i32X2 ? i32X1 :i32X2 ; // 开 始 列 
ui8LineBuf[ 2 | =95; // 结 束 列 
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u8LineBuf[ 3 ] =0x75; //0x75 是 行 地 址 设置 命令 
ui8LineBuf[ 4 | =i32Y; // 开 始 行 
ui8LineBuf[ 5 | =63; // 结 束 行 








CFAL96x64x16WriteCommand( ni8LineBuf,6),  // 发 送 ui8LineBuf[ 16] 数 组 的 前 6 个 元 素 























// 给 写 命令 函数 
// 
// 使 用 缓冲 器 中 的 像素 画 线 ,所 以 可 在 同一 时 间 发 送 多 个 字 节 ;用 线 的 颜色 填充 缓冲 区 
// 





for( uldx =0; uldx < sizeof( ui8LineBuf) ; uldx ++ ) 
| 
ui8LineBuf[ uldx | = ui32Value; 


uldx = (132X1 <i32X2) ? (32X2 -132X1) : (i132X1 -132X2); 
uldx +=1 
while( uldx) 
| 
CFAL96x64x16WriteData( ui8LineBuf, (uldx <16) ? uldx : 16); 
uldx -= (uldx <16) ? uldx:16; 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 玉米 米 米 米 玉米 玉米 米 玉米 米 玉米 米 米 米 米 米 米 玉米 米 米 米 米 米 
//! 初始 化 显示 驱动 程序 

//! 该 函数 初始 化 面板 上 的 SSD1332 显示 控制 器 , 交 
//! 通信 采用 串 行 SPI 方式 


// ネネ ポポ ネネ ボボ ポポ ポポ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボネ ポポ ポポ ボボ ボボ ポポ ボボ ポポ ボボ ボボ ポポ ボボ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ポポ ボボ ポポ ポポ ネネ ポポ 





サ 





备 要 显示 的 数据 









































void 

CFAL96x64x16Init( void ) 

//PinoutSet( void) // 设 置 引 脚 及 外 设 功 能 函数 
| 


tRectangle sRect; 


ノ / 

// 使 能 该 驱动 程序 的 外 设 

// 

ROM_SysCtlPeripheralEnable( DISPLAY_SSI_PERIPH ) ; 
ROM_SysCtlPeripheralEnable( DISPLAY_SSI_CPIO_PERIPH ) ; 
ROM_SysCilPeripheralEnable( DISPLAY_RST_GPIO_PERIPH) ; 





ン 

// 选 择 SSI 功能 的 相应 引 脚 

ン 

ROM_CPIOPinConfigure( DISPLAY_PINCFC_SSICLK) ; 
ROM_CPIOPinConfigure( DISPLAY_PINCFG_SSIFSS) ; 
ROM_CPIOPinConfigure( DISPLAY_PINCFC_SSITX ) ; 
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// 
// 配 置 引 脚 为 SSI 功能 
// 
ROM_GPIOPinTypeSSI( DISPLAY_SSI_PORT,DISPLAY_SSI_PINS) ; 


























// 
// 配 置 显示 控制 引 脚 为 CPIO 输出 
// 


ROM_CPIOPinTypeCPIOOutput(DISPLAY_RST_PORT,DISPLAY_RST_PIN ) ; 
ROM_GPIOPinTypeCPIOOutput(DISPLAY_ENV_PORT,DISPLAY_ENV_PIN) ; 
ROM_GPIOPinTypeGPIOOutput( DISPLAY_D_C_PORT, DISPLAY_D_C_PIN) ; 





ノ // 

// 复 位 引 脚 为 高 电 平 ,关闭 电源 

// 

ROM_GPIOPinWrite( DISPLAY_RST_PORT,DISPLAY_RST_PIN ,DISPLAY_RST_PIN ) ; 
ROM_GPIOPinWrite( DISPLAY_ENV_PORT,DISPLAY_ENV_PIN,0) ; 
ROM_SysCIDelay( 1000 ) ; 





// 

// 在 执行 其 他 程序 时 ,驱动 复位 引 脚 可 拉 低 

// 

ROM_GPIOPinWrite( DISPLAY_RST_PORT, DISPLAY_RST_PIN ,0) ; 


ン 
// 配 置 SSI 端口 
// 
ROM_SSIDisable(DISPLAY_SSL_ BASE ) ; 

ROM_SSIConfigSetExpClk( DISPLAY_SSI_BASE,ROM_SysCHClockCet( ) ， 

SSI FRF_MOTO_MODE_3,SSI_MODE_MASTER, 
DISPLAY_SSI_ CLOCK,8) ; 

ROM_SSIEnable( DISPLAY_SSI_BASE) : 














// 

// 复 位 后 显示 

ノ // 

ROM_SysCIDelay( 1000) ; 

ROM_GPIOPinWrite( DISPLAY_RST_PORT,DISPLAY_RST_PIN,DISPLAY_RST_PIN) ; 
ROM_SysCIDelay( 1000) ; 


// 

// 使 能 显示 器 电源 

// 

ROM_GPIOPinWrite( DISPLAY_ENV_PORT,DISPLAY_ENV_PIN,DISPLAY_ENV_PIN) ; 
ROM_SysCtlDelay(1000 ) ; 























// 
// 发 送 初 始 配 置 命令 字 节 到 显示 
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// 
CFAL96x64x16WriteCommand(g_ui8DisplayInitCommands, 

sizeof( g_ui8 DisplayInitCommands ) ) ; 
ROM_SysCuDelay( 1000 ) ; 
































// 
// 用 黑色 的 矩形 填 满 整个 液晶 屏 

// 

sRect. i16XMin =0; // 列 起 始 坐 标 
sRect. i16XMax =95; // 列 结束 坐标 
sRect. i16YMin =0: // 行 起 始 坐 标 
sRect. i16YMax =63; // 行 结束 坐标 











CFAL96x64x16RectFill(0,&sRect,0); /第 一 个 0 表示 :未 使 用 特殊 数据 ;第 二 个 0 
// 表 示 : 黑 色 ;&sRect 表示 :矩形 





| 


2. 图 形 基 元 层 
图 形 基 元 层 提 供 了 一 组 低层 的 绘图 操作 。 这 些 操作 包括 画 线 、 圆 、 文 本 和 位 图 等 。 人 允许 
多 个 绘图 操作 使 用 离 屏 缓冲 区 ， 并 将 最 后 的 结果 一 次 性 复制 到 屏幕 上 。 
(1) 常用 数据 结构 定义 
① tCodePointMap 结构 体 ， 见 表 16-13。 
表 16-13 tCodePointMap 











typedef struct 
} 
uint16_t uil6SrcCodepage ; 
uint16_t uil6FontCodepage ; 
定义 uint32_t ( * pfnMapChar ) ( const char * pcSrcChar， 
uint32_t m32Count , 
uint32_t * pui32Skip ) ; 


1 


| 
tCodePointMap 



































成 员 描述 

uil6SrcCodepage 代码 页 用 来 描述 源 字 符 

uil6FontCodepage 映射 到 源 字 符 的 代码 页 

pfnMapChar 用 于 将 输入 字符 串 转换 成 输出 代码 页 的 代码 点 的 转换 函数 指针 

功能 描述 用 于 定义 一 种 映射 函数 的 结构 ， 此 函数 可 以 将 代码 页 中 的 文本 转换 到 不 同 的 代码 页 。 这 
り 有 村 好 通常 用 于 将 文本 字符 串 转换 成 所 需要 的 码 点 ， 以 检索 一 个 适当 的 字形 字体 








② tContext 结构 体 ， 见 表 16-14。 
表 16-14 tContext 


typedef siruct 
} 


上 
int32_t 132Size; 
const tDisplay * psDisplay; 
tRectangle sClipRegion ; 
uint32_t ui32Foreground ; 
uint32_t ui32Background ; 
const tFont * psFont; 
void ( * pfnStringRenderer) ( const struct _tContext * ， 
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const char  ， 
int32_t, 
int32_t, 
int32_t, 
bool ) ; 
定义 const tCodePointMap * pCodePointMapTable; 
uint16_t uil6Codepage; 
uint8_t ui8 NumCodePointMaps; 
uint8_t ui8CodePointMap ; 
uint8_t ui8Reserved ; 
| 
tContext 
成 员 描述 
132Size 结构 体 的 大 小 
pDisplay 在 屏幕 上 执行 绘图 操作 
sClipRegion 在 屏幕 上 绘图 时 所 使 用 的 裁减 区 域 
ui32Foreground 在 屏幕 上 绘制 图 形 的 前 景色 
ui32Background 在 屏幕 上 绘制 图 形 的 背景 色 
psFont 在 屏幕 上 泻 染 文本 的 字体 
phnStringRenderer 指向 替换 字符 串 泻 染 函数 的 指针 。 应 用 程序 能 够 使 用 它 为 特定 语言 字符 串 提 供 泻 染 支 
持 。 如 果 设 置 了 该 功能 ， 则 其 通过 调用 GrStringDraw 函数 来 控制 
pCodePointMapTable 用 于 映射 在 各 种 被 支持 的 源 代 码 页 与 使 用 字体 所 支持 的 代码 页 之 间 的 功能 
um16Codepage 当前 选 定 的 源 文 本 的 代码 页 
ui8 NumCodePointMaps 在 pCodePointMapTable 数组 中 的 条 目 数 
ui8CodePointMap 基于 选 定 的 代码 页 和 当前 字体 的 代码 点 映射 表 条 目的 索引 
ui8Reserved 保留 用 于 将 来 的 扩展 
功能 描述 该 结构 定义 了 用 于 在 屏幕 上 绘图 的 绘图 上 下 文 ， 在 任何 时 候 可 以 存在 多 种 绘图 上 下 文 














③ tFont 结构 体 ， 见 表 16-15 。 
表 16-15 tFont 


typedef struct 
| 
uint8_t ui8Format; 


uint8_t u8MaxWidth ; 
uint8_t ui8 Height; 























定义 
人 uint8_t ui8 Baseline; 
uint16_t puil6 Offset[ 96 ] ; 
const uint8_t * pui8 Data ; 
上 
} 
tFont 
ui8 Format 字体 的 格式 ， 为 FONT_ FMT_UNCOMPRESSED 、FONT_FMT_PIXEL_RLE 其 中 之 一 
ui8 Max Width 字符 的 最 大 宽度 ， 这 是 字体 中 的 最 宽 字 符 ， 任 何 单个 的 字符 可 能 比 这 个 宽度 罕 
ui8 Height 字符 单元 的 高 度 ， 这 可 能 比 字符 的 字体 数据 高 (提供 行 间 距 ) 





uig Baseline 字符 单元 的 项 部 和 字符 的 字形 的 基线 之 间 的 偏 移 量 。 基 线 是 大 写字 母 的 底部 行 ， 低 于 基线 仅 出 现 
seline | 在 下 行 小 写字 母 的 情况 









































puil6 Offset 在 字体 中 的 每 一 个 字符 数据 在 pui8Data 中 的 偏 移 量 

pui8 Data 指向 字体 数据 指针 

功能 描述 该 结构 描述 J 在 屏幕 上 绘制 文本 所 用 的 字体 ， 此 格式 的 字体 可 以 用 0x20 ~0x7F 范围 内 的 代码 点 将 
字体 编码 成 ASCII 字符 
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④ tGrLibDefaults 结构 体 见 表 16-16。 
表 16-16 tGrLibDefaults 

















































































































typedef struct 
1 
void ( * pfnStringRenderer ) ( const struct _tContext * ， 
const char * ， 
int32_t, 
int32_t, 
SN int32_t, 
定义 bool) ; 
tCodePointMap * pCodePointMapTable ; 
uint16_t uil6Codepage ; 
uint8_t ui8 NumCodePointMaps ; 
uint8_t ui8 Reserved : 
| 
} 
tGrLibDefaults 
成 员 省 述 
fnStringRenderer 使 用 的 默认 字符 串 演 染 函数 ， 一 般 为 GrDefaultStringRenderer 函数 ， 但 当 支 持 语 言 需 由 如 
ee 阿拉 伯 语 和 希 伯 来 语 混合 来 直接 泻 染 时 ， 则 将 被 替换 
CodePointManTable 默认 的 代码 点 映射 函数 表 ， 这 个 表 包 含 允 许 在 源 代码 页 中 映射 GrLib 文本 信息 为 使 用 中 
WI | 字体 的 正确 字形 。 指 向 字段 结构 体 数组 的 第 一 个 元 素 
uil6Codepage 由 应 用 程序 使 用 的 默认 源 文本 代码 页 编码 
ui8NumCodePointMaps 在 pCodePointMapTable 数组 中 的 条 目 数 量 
ui8 Reserved 呆 留 
功能 描述 该 结构 包含 在 通过 调用 GrContextInit 初始 化 任何 新 上 下 文 设置 的 默认 值 ， 该 结构 通过 使 
用 GrLibInit 函数 传递 到 图 形 库 








⑤ tRectangle 结构 体 ， 见 表 16-17。 
表 16-17 tRectangle 



























































Typedef struct 
1 
int16_t i16XMin; 
定义 int16_t i16YMin; 
int16_t i1 6XMax; 
int16_t i16YMax; 
1 
) 
tRectangle 
成 员 描述 
i16XMin 征 形 的 最小 X 坐标 
i16YMin 年 形 的 最小 Y 府 株 
i16XMax 年 形 的 最大 X 詩 株 
i16YMax 和 矩 形 的 最 大 Y 坐标 
功能 描述 该 结构 体 定义 了 和 矩形 的 坐标 信息 ， 所 有 点 坐标 等 于 或 大 于 最 小 坐标 ， 小 于 或 等 于 最 大 坐标 
(2) 和 常用 图 形 基 元 层 的 固件 库 函 数 





稼 用 图 形 基 元 层 的 固件 库 函 数 见 表 16-18 -16-31 。 
表 16-18 GrCircleDraw 


功能 画 一 个 圆 





void CrCircleDraw( const tContext * pContext, 
int32_ti32X, 
int32_t i32Y ， 
int32_t i32Radius ) 
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参数 描述 
pContext 指 向 使 用 的 绘制 上 下 文 的 指 针 
i32X 圆心 的 X 坐标 
i32Y 同心 的 Y 坐标 
132Radius 圆 的 半径 
功能 描述 此 函数 利用 Bresenham 绘图 算法 绘制 一 个 圆 。 圆 的 范围 : x 坐标 从 i32X - i32Radius 到 32X + 
132Radius; y 坐标 从 i32Y - 32Radius 到 i32Y + i32Radius (包括 边界 ) 
返回 参数 无 
表 16-19 GrCircleFill 
功能 画 一 个 实心 圆 
void GrCircleFill( const tContext * pContext, 
ーー | int32_t 132X， 
函数 原型 int32_t 132Y ， 
int32_t 132Radius ) 
参数 描述 
pContext 指向 使 用 的 绘制 上 下 文 的 指针 
i32X 圆心 的 X 坐标 
i32Y 圆心 的 Y 坐标 
i32Radius 圆 的 半径 
功能 描述 此 函数 利用 Bresenham 绘图 算法 绘制 一 个 实心 的 圆 。 圆 的 范围 : x 坐标 从 i32X - 32Radins 到 
Nei 132X + i32Radius: y 坐标 从 i32Y -i32Radius 到 i32Y + i32Radius (包括 边界 ) 
返回 参数 无 
表 16-20 GrContextFontSet 
功能 设置 在 使 用 中 的 字体 
函数 原型 void GrContextFontSet( tContext * pContext,const tFont * psFont ) 
参 数 描述 
pContext 指向 修改 的 绘图 上 下 文 的 指针 
pFont 指向 被 使 用 字体 的 指针 
功能 描述 该 函数 用 于 在 指定 的 绘图 上 下 文中 设置 字体 ， 以 便 进行 符 串 的 绘图 操作 
返回 参数 无 
表 16-21 GrContextInit 
功能 初始 化 绘图 上 下 文 
函数 原型 void GrContextInit( tContext * psContext, const tDisplay * psDisplay ) 
输入 参数 措 述 
pContext 指向 待 初始 化 的 绘图 上 下 文 的 指针 
pDisplay 首 向 描述 使 用 显示 驱动 的 tDisplayInfo 结构 的 指针 
功能 描述 该 函数 初始 化 一 个 绘图 上 下 文 来 准备 使 用 。 所 提供 的 显示 驱动 程序 将 被 用 于 所 有 后 续 的 图 形 
操作 ， 且 默认 的 裁剪 区 域 将 被 设置 成 屏幕 的 范围 
返回 参数 无 








367 


表 16-22 GrFontHeightGet 



































功能 获取 字体 的 高 度 

函数 原型 uint32 t GrFontHeightGet (const tFont * psFont) 

输入 参数 描述 

pFont 指向 待 查询 字体 的 指针 

功能 描述 该 函数 决定 一 个 字体 的 高 度 。 字 体高 度 为 字体 的 项 部 和 底部 的 字体 之 间 的 偏 移 量 ,包括 任何 
上 半 格 和 下 半 格 的 字母 

返回 参数 返回 以 像素 为 单位 的 字体 高 度 




















表 16-23 GrFontMaxWidthGet 























功能 获取 字体 最 大 宽度 

函数 原型 uint32 1 GrFontMaxWidthGet (const tFont * psFont) 

输入 参数 描述 

pFont 指向 待 查询 字体 的 指针 

功能 描述 此 函数 用 于 确定 一 个 字体 的 最 大 宽度 。 最 大 宽度 为 字体 中 单个 字符 最 宽 的 宽度 
返回 参数 返回 以 像素 为 单位 的 字体 最 大 宽度 























表 16-24 GrFontNumBlocksGet 

























































































功能 返回 字体 中 字符 编码 块 的 数量 
函数 原型 uint16_t GrFontNumBlocksGet (const tFont * psFont) 
输入 参数 描述 
pFont 指向 要 字体 查询 的 指针 
功能 描述 此 函数 可 用 于 查询 给 定 字体 编码 代码 点 (字符 ) 连续 块 的 数量 。 这 主要 用 于 直接 解析 字体 ， 
例如 ， 显 示 字 体 中 的 所 有 字形 
返回 参数 返回 字体 中 代码 点 块 的 数目 
表 16-25 GrImageDraw 
功能 绘制 位 图 图 像 





void CrhmageDraw( const tContext * pContext, 
const uint8_t * pui8Image, 


函数 原型 int32_ti32X ， 
int32 ti32Y ) 

















































































































输入 参数 措 述 
pContext 指向 使 用 的 绘图 上 下 文 的 指针 
pui8Image 首 向 待 绘制 的 图 像 的 指针 
i32X 图 像 左 上 角 的 X 坐标 
i32Y 图 像 左 上 角 的 Y 坐标 
此 函数 用 于 绘制 位 图 图 像 。 图 像 可 以 是 每 像素 1 位 (用 于 绘图 上 下 文中 使 用 前 景色 和 背 
功能 描述 景色 ) ， 每 像素 4 位 (为 调 色 板 中 提供 图 像 数 据 )， 或 每 像素 8 位 (为 调 色 板 中 提供 图 像 
J 過 摘 数据 ) 图 像 数 据 可 以 是 未 压缩 的 数据 ， 也 可 以 使 用 Lempel - Ziv - Storer - Szymanski 算法 对 
其 进行 压缩 
返回 参数 无 
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表 16-26 GrLineDraw 





























































































































































































































功能 绘制 一 条 直线 
void GrLineDraw( const tContext * pContext , 
int32_t i32X1 , 
函数 原型 imt32 ti32Y1 , 
int32_t 132X2 , 
int32_ti32 Y2 ) 
输入 参数 省 述 
pContext 指向 要 绘图 上 下 文 的 指针 
i32X1 直线 起 始 位 置 的 X 坐标 
i32Y1 直线 起 始 位 置 的 Y 坐标 
i32X2 直线 结束 位 置 的 X 坐标 
i32Y2 直线 结束 位 置 的 Y 坐标 
返回 参数 无 
表 16-27 GrLineDrawH 
功能 绘制 一 条 水 平 线 
void GrLineDrawH( const tContext * pContext, 
ee i int32_t i32X1 ， 
函数 原型 int32_t i32X2 , 
int32_t i32Y ) 
输入 参数 省 述 
pContext 指向 要 绘图 上 下 文 的 指针 
i32X1 直线 起 始 位 置 的 X 坐标 
i32X2 直线 结束 位 置 的 X 坐标 
i32Y 直线 的 Y 坐标 
返回 参数 无 
表 16-28 GrLineDrawV 
功能 绘制 一 条 垂直 线 
void GrLineDrawV( const tContext * pContext, 
六 | int32_ti32X ， 
函数 原型 int32_t i32Y1 , 
int32_t 132Y2) 
输入 参数 省 述 
pContext 指向 要 绘图 上 下 文 的 指针 
i32X 直线 的 X 坐标 
i32Y1 直线 起 始 位 置 的 Y 坐标 
i32Y2 直线 结束 位 置 的 Y 坐标 
返回 参数 无 
表 16-29 GrRectDraw 
功能 绘制 一 个 矩形 
函数 原型 void GrRectDraw( const tContext * pContext ,const tRectangle * pRect) 
输入 参数 描述 








了 0 了 


( 续 ) 











pContext 指向 待 绘图 上 下 文 的 指针 
pRect 指向 包含 矩形 内 容 的 结构 指针 
返回 参数 无 





表 16-30 GrRectFil 




















功能 绘制 一 个 填充 的 矩形 

函数 原型 void GrRectFill( const tContext * pContext,const tRectangle * pRect) 
输入 参数 描述 

pContext 指向 待 绘图 上 下 文 的 指针 

pRect 指向 包含 矩形 内 容 的 结构 指针 

返回 参数 无 





表 16-31 GrStringDraw 





功能 绘制 一 个 字符 串 





void GrStringDraw( const tContext * pContext, 
const char * pcString, 


int32_t i32Length , 









































abs Ul 

函数 原型 int32_ti32X ， 
int32_t i32Y ， 
uint32_t bOpaque) 

输入 参数 前述 

6 指向 要 绘图 上 下 文 的 指针 

人 各 向 要 绘制 的 字符 串 指针 

NE 应 绘制 在 屏幕 上 的 字符 串 的 字符 数 

屏幕 上 字符 串 的 起 始 位 置 X 坐标 

屏幕 上 字符 串 的 起 始 位 置 Y 坐标 

paque 为 真 时 ， 可 以 绘制 每 一 个 字符 的 背景 色 ， 为 假 时 则 不 可 以 
返回 参数 无 





3. 小 工具 层 

小 工具 层 位 于 图 形 基 元 层 之 上 ， 由 如 下 小 工具 组 成 : 

① 画布 小 工具 (Canvas Widget) 。 

② 复 选 框 小 工具 (Checkbox Widget) 。 

③ 容器 小 工具 (Container Widget) 。 

④ 图 形 按 钮 小 工具 (Image Button Widget) 。 

⑤ 列表 框 小 工具 (ListBox Widget) 。 

⑥ 键盘 小 工具 (Keyboard Widget) 。 

@ 按钮 小 工具 (Push Button Widget) 。 

单 选 按钮 小 工具 (Radio Button Widget) 。 

⑨ 滑 块 小 工具 (Slider Widget) 。 

在 遇 到 绘制 以 上 列 出 的 小 工具 图 形 时 ， 仅 需 简单 调用 这 些 函 数 即 可 实现 ， 比 前 面 的 显示 
驱动 屋 和 图 像 基 元 层 绘图 来 得 方便 。 这 些 固件 库 图 形 函 数 请 参考 TI 的 图 形 库 函 数 (SW - 
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TM4C - GRL -UG -2.0. 1. 11577 ) 的 小 工具 部 分 。 
实用 工具 (Utilities ) 


在 TivaWare 软件 包 的 tools/bin 目录 下 ， 提 供 了 几 个 处 理 与 TivaWare 图 形 库 不 兼容 的 文 
字 、 图 形 、 制 作 字 符 串 表 的 工具 : frasterize 、pnmtoc 、mkstringtable， 以 及 在 tools/lmi - but- 
ton 目录 下 设计 按键 的 Imi - button 脚本 。 下 面 仅 就 ffasterize 和 pnmtoc 工具 的 使用 方 法 作 一 


简介 。 





1. ftrasterize 

可 用 ftrasterize 工具 来 生成 与 TivaWare 图 形 库 兼 容 的 字体 ， 其 操作 步 又 如 下 : 

1) 创建 一 个 转换 字体 的 目录 。 为 了 防止 Windows 操作 系统 某 个 字体 由 于 操作 字体 
转换 而 被 无 意 中 删 除 ， 最 好 在 C:\ 创 建 一 个 目录 ， 例 如 : C:\Makemyfontandpicture。 由 
于 frasterize 工具 支持 TrueType@ 、 OpenType® 、 PostScript® Type 1Windows@ FNT 字体 的 
转换 ， 因 此 可 在 C:\Windows \Fonts 目录 下 把 TrueType 字体 文件 复制 到 所 创建 的 目录 
下 ， 比 如 复制 Arial 字体 。 然 后 再 把 ftrasterize 工具 也 复制 到 C: \ Makemyfontandpicture 
中 ， 如 图 16-23 所 示 。 


名 称 修改 日 期 类 型 


而 | ftrasterize sj2013/11/12 17:01 ”应 用 程序 




















图 16-23 ”选中 的 TrueType 字体 文件 与 ftrasterize 工具 








2) 字体 转换 。 
① frasterize 的 命令 格式 : 


ftrasterize | -a <num> | | -b] | -c <filename > ] | -d] | -e <num> | | -f <name> |] 
| -h] | - 計 [|[ -ml [| -n] [ -o <num>][-p <mum>] [| -r|] | -s [F] <size > ] 
| -t <num> | | -ul | -v] | -w <num> | | -y] | -z く num > | く font > 


其 中 常用 的 几 个 参数 含义 为 ，-b 为 黑体 ，-f <name > 为 这 个 字体 的 名 称 ;， -s < size > 
指定 字体 大 小 ; -m 指定 输出 的 字体 要 等 宽 。 其 他 参数 介绍 请 参考 图 形 库 的 Utilities 
部 分 。 

② 转换 操作 。 在 命令 行 中 输入 : ftrasterize -f arial -s 30 arial. tf， 如 图 16-24 
所 示 。 

2. pnmtoc 

可 用 pnmtoc 工具 来 生成 与 TivaWare 图 形 库 兼 容 的 图 片 ， 操 作 步 又 如 下 : 

1) 下 载 并 安装 netpbm (pnm) 格式 的 图 片 转换 工具 CIMP。 在 http://www. gimp. org 下 
载 jpeg、GIF 、BMP、TIFF 等 格式 图 片 转 换 成 netpbm (pnm) 格式 的 工具 GIMP, 选择 
用 户 自 定 义 安 装 。 在 安装 时 选中 如 网 16-25 所 示 的 选项 。 

2) 将 jpeg 等 格式 图 片 转换 成 pnm 格式 图 片 ， 如 图 16-26 与 16-27 所 示 。 
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管理 员 : C\Windows\system32\cmd.exe 








上 
i 


版 权 所 有 (c) 2993 Hicrosoft Corporation。 保留 所 


CO ED 


| > 


C:NUserst11uuu>cd. . 
C:NUsers>cd. . 


E:\N>cd Makemufontandpicture 


EiNWakemgfontandpicture>Etrasteriz-f ar1a] -s 39 ar1a1 .ttf 
FTRasterize: Generate a TiuaUare GrLib-compatib1e font . 
Copuright 2008-2011 Texas Instruments Incorporated . 


半 : 











图 1e-24 字体 转换 操作 





> 
而 setup - GIMP 












Select file associations 
Select file associations 





| 团 JPEG image 
| KISS CEL 
MMNetpbm format 
_| Portable Netwiork Graphics 


へ 同 Bpstscrp Encapsulated Po 























图 16-25 ”安装 时 需 选中 的 选项 
加 | 索 引 颜色 转换 本 
加 将 图 像 转换 为 索引 颜色 | 来 al 来 | 
[image] (已 导入 )-1 
顔色 表 到 
























































使 用 网 页 优化 色 板 。 3 
国 *[image] (已 导入 )-1.0 (RGB 颜色 .Ei 回 同和 + 使 用 黑白 (1 位 色 板 
文件 (F) 编辑 (E) 选择 (S) 查 图 层 (L) 』 の 使 用 自 定义 色 板 


= - 
器 | oo， 








HE 面授 制 (D) 











待 转换 的 医 














图 16-26 





3) 保存 转换 后 


jpeg 格式 一 pnm 格式 图 片 的 转换 过 程 





























本 用 
颜色 拌 动 (D) : 无 
」 启用 透明 度 拌 动 中 


帮助 (H) 




















Y 


转换 (9) 














的 图 片 ， 将 扩展 名 修改 为 . pnm， 如 图 16-28 所 示 。 


图 16-27 选中 256 色 


4) 用 pnmitoc 工具 生成 .c 格式 的 图 片 数据 。 在 命令 行 中 输入 : pnmtoc - c CIMP. pnm > 
GIMP. c， 如 图 16-29 所 示 。 
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图 保存 图 像 








名 称 (N) : GIMPlpnm 





扩展 名 修改 为 .pnm 





保存 于 文件 赤 (F) : | [Makemyfentandpicture] 













过 扩展 名 不 匹配 2< 





The given filename cannot be used for saving 3 


您 可 以 用 此 对 话 框 保存 到 GIMP XCF 格式 。 使 用 文件 一 
导出 以 导出 到 其 他 文件 格式 。 a 9 
生成 .pnm 格 式 D> 


Take me to the Export dialog 




























16-28 将 GIMP. XCF 修改 为 GIMP. pnm 





r 





回 管理 员 : C:\Windows\system32\cmd.exe | = Ep 















C:\>ed Makemyfontandpicture 











C:\Makemyfontandpicture>pnmtoc -¢ GIHMP.Pnm>GIMP .c 


C:\Makemyfontandpicture> 





GIMP.c x > 























en ans tone 天 全 
1 On3 七 uin モ 8 上 q pui8Tmage「] = 
2 日 { 
3 TMAGE FMT 8BPP COMP, 
a 106, 0, 
5 78, 0, 生成 的 图 片 数 据 ! | 入 
6 号 
255 注意 : 在 使 用 时 需 
8 0x04，0x0a，0x08， 添加 grlib/grlib.h 
9 0x11, Ox08, Ox 头 文件 
0 0x04, Ox01, Ox1f 
1 Ok2 下 。 OO 




















图 16-29 用 pnmtoc 工具 产生 的 图 片 数据 








预定 义 的 颜色 参考 


在 grlib. h 中 预定 义 了 一 组 用 于 在 屏幕 上 绘制 图 形 的 颜色 ， 而 其 他 颜色 则 可 通过 指定 
RGB 的 值 来 得 到 。 预 定义 颜色 给 基于 图 形 的 应 用 带 来 了 很 大 方便 ， 其 样式 如 图 16-30 所 示 。 
所 有 预定 于 的 颜色 请 参考 图 形 库 中 的 “15 Predefined Color Reference”(269 ~273 页 ) 部 分 。 








ClrBlack CIrDimGray ClrGray 
CIrDarkGray ClrSilver ClrLightGray 
CIrGainsboro ClrWhiteSmoke ClrWhite 
ClrRosyBrown ClrIndianRed CIrBrown 
半生 





ClrFireBrick ClrLightCoral ClrMaroon 


图 16-30 预定 于 颜色 的 样式 
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在 前 几 音 的 例 程 中 已 使 用 过 用 TFT - LCD 液晶 屏 来 显示 TM4F 处 理 器 输出 的 信息 ， 为 了 











便于 更 多 的 读者 对 图 像 库 例 程 在 BD - LM4F232 - UM (相似 板 卡 dk - tm4c123s) 进行 验证 ， 
下 面 将 以 TI 提供 的 grlib_demo 例 程 为 例 来 介绍 图 形 库 的 使 用 及 编程 方法 。 
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1) grlib_demo. ce 介绍 。 


アク 人 た キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キキ キ キキ キキ キキ キ キキ キキ キキ キキ キキ コ 
// 文 件 名 :grlib_demo. c ~ Demonstration of the TivaWare Graphics Library. 

// 来 源 :TI 例 程 

// 功 能 :该 例 程 演示 了 基本 图 形 的 绘制 方法 ,包括 : 画 线 . 画 圆 . 画 和 矩形 .显示 字符 呈 
// 形 等 


// 米 米 米 六 六 六 米 米 米 米 六 米 米 米 米 米 米 六 六 闵 米 米 米 米 六 六 玉米 米 米 米 六 六 六 玉米 米 米 六 六 六 六 六 米 六 玉米 六 玉米 米 米 六 六 六 米 闵 玉米 六 六 六 米 闵 玉米 玉 六 六 米 闵 六 六 六 六 六 六 








和 图 


Ud 








#include < stdint.h > 

#include < stdbool. h > 

#include "inc/hw_sysctl. h" 
#include " driverlib/rom. h" 
#include " driverlib/sysctl. hy" 
#include " grlib/grlib. h" 

#include " drivers/cfal96x64x16.h" 


ノ / 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 炒米 炒米 米 米 米 米 米 米 炒米 米 米 炒米 米 米 米 米 


// 图 形 上 下 文 用 于 文字 在 CSTN 屏 上 的 显示 


ノ / 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 玉米 米 米 米 米 炒米 炒米 米 米 米 米 米 米 炒米 米 米 炒米 米 米 米 米 








tContext g_sContext: 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 玉米 米 米 米 米 炒米 炒米 米 米 米 米 炒米 米 米 米 


//TI 柄 志 國 形 数 据 


ノ / 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 炒米 米 米 米 米 玉米 炒米 米 米 炒米 炒米 米 米 米 米 炒米 米 米 米 





const uint8_t g_pui8Logo| | = 
| 
IMAGE_FMT_4BPP_COMP, 
30 ,0 ， 
30 ,0 ， 
// 参 考 dk - tm4c123s 板 中 的 grlib_demo 例 程 相关 部 分 
0x70 ,0x40 ,0x17 ,0x47 ,0x77 


) 
) 5 


// ネネ ボボ ポポ ポポ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ ポポ ボボ ポポ ポポ 来 ボ ポポ ボボ ポポ 来 ボボ ポポ ポポ 来 ボ ボ 来 ポポ ポ 来 来 ボ ポポ ポポ 来 ボ ボボ ポポ ポポ 


// 如 果 驱 动 程序 库 遇 到 错误 将 调用 错误 处 理 程序 


ノ / 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 炒米 米 米 米 米 玉米 炒米 米 米 炒米 炒米 米 米 米 米 炒米 米 米 米 


#ifdef DEBUG 


void 











_ error_ (char * pcFilename,uint32_t ui32Line) 


#endif 


ノ / 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 炒米 米 米 米 米 炒米 炒米 米 米 炒米 炒米 米 米 米 米 炒米 米 米 米 


// 一 个 简单 的 TivaWare 图 形 库 特性 的 例 程 


// 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 米 米 米 米 米 米 炒米 米 米 米 米 米 米 米 米 米 米 米 米 炒米 米 米 米 米 炒米 炒米 米 米 米 米 玉米 炒米 米 米 炒米 炒米 米 米 米 米 炒米 米 米 米 





int 

main( void ) 

| 
uint32_t ui32Idx; 
tRectangle sRect; 


ノ / 

// 中 断 处 理 程 序 使 能 扩展 堆栈 
ノ / 
ROM_FPULazyStackingEnable( ) ; 








// 
// 设 置 从 PLL 运行 的 时 钟 为 50MHz 
// 


ROM_SysCtlClockSet( SYSCTL_SYSDIV_4 | SYSCTL_USE_PLL | SYSCTL_XTAL 16MHZ | 
SYSCTL_OSC_MAIN) ; 


// 
// 初 始 化 显示 驱动 程序 
// 
CFAL96x64x16Init( ) ; 


// 

// 初 始 化 图 形 上 下 文 

// 

GrContextInit( &g_sContext, &g_sCFAL96x64x16 ) ; 





























// 
// 用 蓝 色 填充 屏幕 顶部 的 12 行 以 创建 一 个 蓝 色 条 
// 


sRect. i16XMin =0; 

sRect. i16YMin =0; 

sRect. i16XMax = GrContextDpyWidthGet( &g_sContext) —1; 
sRect. i16YMax =11: 





GrContextForegroundSet( &g_sContext ,ClrDarkBlue ) ; // 前 景 :深蓝 
GrRectFill( &g_sContext, &sRect) ; // 填 充 知 形 
ノ // 

// 在 蓝 色 条 的 周围 套 一 个 白 框 

メグ 

GrContextForegroundSet( き g_sContext,ClrWhite ) ; // 前 景 :白色 


GrRectDraw( &g_sContext, &sRect) ; 
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// 

// 把 程序 名 放 在 蓝 色 条 的 中 间 

ノ / 

GrContextFontSet(&g_sContext,g_psFontfixed6xS8 ) ; 

GrStringDrawCentered( &g_sContext, " grlib_demo" , -1 , 
GrContextDpyWidthGet(&g_sContext) / 2,5,0) : 








/ 
// 画 一 条 垂直 扫描 线 由 红 一 绿 
// 


for( ui32Idx =0;ui32Idx <=8; ui32Idx ++ ) 
| 
GrContextForegroundSet( &g_sContext, 
(((((10 -ui32Idx) * 255) / 8) << ClrRedShift) | 
(((ui32Idx * 255) / 8) << ClrGreenShift) ) ) ; 
GrLineDraw( &g_sContext,60,60,0,60— (5 * ui32Idx) ) ; 








// 
// 画 一 条 水 平 扫描 线 由 红 绿 一 蓝 
// 


for( ui32Idx =1; ui32Idx < = 11: ui32Idx ++) 
| 
GrContextForegroundSet( &g_sContext, 
(((((11 -ui32Idx) * 255) / 11) << 
ClrGreenShift) | 
(((ui32Idx * 255) /11) << ClrBlueShift) ) ) ; 
GrLineDraw( &g_sContext ,60 ,60, (ui32Idx * 5),20); 




















XY 

// 绘 制 重合 的 实心 加 

KS 

GrContextForegroundSet( &g_sContext,ClrBlue ) ; // 前 景 : 蓝 色 
GrCircleFill( &g_sContext ,80 ,30 ,15 ) ; // 用 蓝 色 填充 圆 
GrContextForegroundSet( &g_sContext ,ClrWhite ) ; // 前 景 :白色 
GrCircleDraw( &g_sContext ,80 ,30 ,15 ) ; // 绘 制 几 

// 绘 制 重 辣 的 矩形 

ルクス 

GrContextForegroundSet( &g_sContext,ClrGray) ; // 前 景 : 放 色 


sRect. i16XMin = 8 ; 

sRect. i16YMin =45: 
sRect. i16XMax =46; 
sRect. i16YMax =351 ; 














GrRectFill( &g_sContext , &sRect) ; // 用 灰色 填充 矩形 
GrContextForegroundSet( &g_sContext, ClrWhite ) ; // 前 景 :白色 





sRect. i16XMin +=4: 


sRect. i16YMin +=4: 
sRect. i16XMax +=4: 
sRect. i16YMax +=4: 
GrRectDraw( &g_sContext, &sRect) ; // 画 一 个 矩形 





// 画 一 段 增 大 尺寸 字体 的 文本 

//Draw a piece of text in fonts of increasing size. 

// 

GrContextForegroundSet( &g_sContext, ClrBlack ) : 
GrStringDraw( &g_sContext, " Strings" , —1,6,16,0); 
GrContextForegroundSet( &g_sContext, ClrSilver) : 
GrStringDraw( &g_sContext, " Strings" , —1,7,17,0) ; 


ノ / 

// 绘 制图 像 

ノ / 

GrTransparentImageDraw(g_sContext,g_pui8Logo,64 ,34 ,ClrBlack ) : 
#if 0 

GrImageDraw(g_sContext,g_pui8Logo ,64,34 ) : 
#endif 





4 

// 刷 新 所 有 绘制 操作 的 缓冲 区 
ノ // 

GrFlush(g_sContext) ; 








LA 
// 无 限 循环 
LA 
while(1) 
| 
| 
| 
2) 在 Keil4.73 中 导入 C:\ti\TivaWare_C_Series - 2. 0. 1. 11577 \examples \ boards \/dk - 
tm4c123g 目录 下 的 grlib_demo 工程 ， 如 图 16-31 所 示 。 





r 
[下 | C:\ti\TivaWare_C_Series-2.0.1.11577\examples\boards\dk-tm4c123 





File Edit View Project Flash Debug Peripherals Tools SVCS “yp 














器 | grlib_demo Cn 起 | 晶 叶 二 了 
? 图 的 grlib_demo.c colo6x6 de 


#endif 









Project 
































驱动 程序 1 





SD Source 


] cfal96x64x16.c 


//*xxxwkxwXXX メ xxxx 蘭 
// 
// 五 simp1e deamonsy 
// 


の たよ よさ よ よ よ よ よなよな よ よ まま よ よ よる 


と 


int 
in (vo1d) 。 # 


較 16-31 导入 grlib_demo 工程 





| 















Taries 


driverlib.lib 
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注意 : 如 果 读 者 在 安装 CCS6. x、Keil4. x 或 IJAR6.x 软 件 时 ， 没 有 一 并 安装 图 形 库 软件 
(grlib. lib) ， 在 编译 grlib_demo 工程 前 需 先 行 安装 该 软件 。 

3) 编译 grlib_demo 工程 ， 并 将 其 结果 导入 到 BD - LM4F232 - UM 板 中 ， 其 测试 结果 如 
图 16-32 所 示 。 


例 程 测试 结果 請 
SMFR “ 





图 16-32 图 形 库 例 程 在 BD - LM4F232 - UM 板 中 的 测试 结果 





注意 : TI 还 提供 了 一 些 有 关 图 形 库 应 用 的 例 程 ， 请 参考 TI 网 站 或 本 书 附 带 的 资料 。 
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附 录 


《% 附录 A 第 3 章 附 录 : UART 固件 库 函 数 简介 


本 章 附 录 简 要 介绍 UART 模块 的 固件 库 函 数 (API) 的 参数 定义 及 功能 说 明 ， 详 细 的 功 
能 说 明 请 参考 TI 文档 . SW - TM4C - DRL - UG - 2.0. 1.11377 。 
注 : 为 了 压缩 固件 库 功 能 说 明 的 篇 幅 ， 省 略 掉 了 注意 事项 部 分 ， 请 读者 注意 。 


表 A-1 UART9BitAddrSend 






















































































功能 在 9 位 模式 下 ， 从 指定 端口 发 送 一 个 地 址 字符 
る 7 本 電 0 void UART9 BitAddrSend (uint32_t ui32 Base , 
函数 原型 uint8_t ui8Addr) 
参数 ui32Base UART 端口 的 基地 址 
9 ui8Addr 待 被 发 送 的 地 址 

该 函数 直到 所 有 数据 都 被 从 指定 端口 发 送 完成 之 后 ， 才 发 送 一 个 给 定 的 地 址 作为 地 址 字 
节 。 在 返回 前 一 直 等 待 地 址 字 节 发 送 完 成 
Es 常用 数据 函数 (UARTCharPut( ) 、UARTCharPutNonBlocking( ) 、UARTCharGet( ) 和 UAR- 

TCharGetNonBlocking( ) ) 可 用 于 在 9 位 模式 下 发 送 和 接收 数据 字符 
返回 参数 无 
表 A-2 UART9BitAddrSet 

功能 设置 9 位 模式 的 设备 地 址 

void UART9 BitAddrSet (uint32_t ui32Base, 
函数 原型 uint8_t ui8 Addr, 


uint8_t ui8Mask ) 





ui32Base UART 端口 的 基地 址 
参数 ui8Addr 设备 地 址 
uiMask 设备 地 址 屏蔽 

















该 函数 配置 设备 地 址 或 响应 9 位 UART 端口 请 求 的 设备 地 址 范围 。 接 收 到 的 地 址 由 地 址 






































描述 飞 项 所 屏蔽 ， 然 后 与 给 定 地 址 比较 ， 允 许 匹配 成 单一 地 址 〈 如 Mask 为 0xD) 或 一 段 地 址 
返回 参数 无 
表 A-3 UART9BitDisable 
功能 禁止 指定 UART 的 9 位 模式 
函数 原型 void UART9 BitDisable (uint32_t ui32Base ) 
参数 u32Base UART 端口 的 基地 址 
描述 该 函数 禁止 UART 的 9 位 操作 模式 
返回 参数 无 
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表 A-4 UART9BitEnable 


























































































































































































































功能 使 能 指定 的 UART 9 位 模式 
函数 原型 void UART9 BitEnable (uint32_t ni32Base ) 
参 数 u32Base UART 端口 的 基地 址 
描述 该 函数 使 能 UART 的 9 位 的 操作 模式 
返回 参数 无 
表 A-5 UARTBreakCtl 
功能 发 送 一 个 BREAK 
函数 原型 void UARTBreakCtl i 0 
参数 ui32Base UART 敵 口 的 基地 址 
bBreakState 输出 电 平 控制 
当 参 数 bBreakState 设置 为 true 时， 调用 该 函数 将 声明 一 个 UART 中 止 条 件 ; 当 bBreak- 
描述 State 设置 为 false 时 ， 调 用 该 函数 将 删除 中 止 条 件 。 而 正确 的 中 止 命令 传输 ， 必 须 保 证 至 
少 两 个 完整 的 帧 
返回 参数 无 
表 A-6 UARTBusy 
功能 确认 UART 是 否 发 送 忙 
函数 原型 tBoolean UARTBusy (uint32_t ni32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
该 函数 允许 调用 者 确定 是 否 所 有 的 传输 字 节 已 清除 了 发 送 器 硬件 。 如 果 返 回 false， 则 发 
描述 送 FIFO 为 空 并 且 最 后 一 个 传输 字符 的 所 有 位 (包括 所 有 的 停止 位 ) 都 移出 了 硬件 移 位 寄 
存 器 
返回 参数 若 UART 正在 发 送 ， 则 返回 tae, 若 所 有 传输 已 完成 ， 则 返回 falses 
表 A-7 UARTCharGet 
功能 等 待 指定 端口 的 一 个 字符 
函数 原型 uint32_t UARTCharCet (uint32_t ui32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 从 指定 端口 的 接收 FIFO 中 获取 一 个 字符 。 如 果 没 有 可 用 的 字符 ， 该 函数 将 一 直 
车 待 ， 直 到 接收 到 一 个 字符 方 可 返回 
返回 参数 返回 从 指定 端口 读 取 的 字符 并 转换 为 int32_t 类 型 
表 A-8 UARTCharGetNonBlocking 
功能 从 指定 的 端口 接收 一 个 字符 
函数 原型 uint32_t UARTCharCetNonBlocking (uint32_t mi32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 从 指定 端口 的 接收 FIFO 中 获取 一 个 字符 
返回 参数 返回 从 指定 端口 读 取 的 字符 并 转换 为 uin32_t 类 型 。 若 在 当前 接收 FIFO 中 没有 字符 ， 
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则 返回 -1。 在 尝试 调用 这 个 函数 前 ， 应 该 先行 调用 函数 UARTCharsAvail( ) 











表 A-9 UARTCharPut 























































































































































































































功能 等 待 从 指定 的 端口 发 送 一 个 字符 
了 i int3 132 Base 
函数 原型 void UARTCharPut Cuint3 2_t ui32Base , 
unsigned char ucData ) 
参数 ui32Base UART 端口 的 基地 址 
= ucData 待 发 送 的 字符 
描述 该 函数 把 字符 ucData 发 送 到 指定 端口 的 发 送 FIFO 中 。 如 果 发 送 FIFO 中 没有 可 用 空间 ， 
a 该 函数 将 一 直 等 待 ， 直 到 有 可 用 空间 再 返回 
返回 参数 无 
表 A-10 UARTCharPutNonBlocking 
功能 发 送 字符 到 指定 端口 
函数 原型 bool UARTCharPutNonBlocking Cuint32_t ui32 Base , 
unsigned char ucData ) 
参 数 ui32Base UART 端口 的 基地 址 
ucData ” 待 发 送 的 字符 
描述 该 函数 将 字符 ueData 写 人 到 指定 端口 的 发 送 FIFO 中 。 此 函数 不 会 阻塞 (block) ， 因 此 ， 
如 果 没 有 可 用 的 空间 将 返回 false， 且 应 用 程序 必须 在 稍 后 重 试 该 函数 
号 如 果 字 符 被 成 功 加 载 到 发 送 FIFO 中 ， 则 返回 bue; 若 在 发 送 FIFO 中 没有 可 用 的 空间 ， 
返回 参数 
则 返回 false 
表 A-11 UARTCharsAvail 
功能 确定 接收 FIFO 中 是 否 有 字符 存在 
函数 原型 Bool UARTCharsAvail (uint32_t ui32 Base ) 
参 数 ui32Base UART 端口 的 基地 址 
= ucData 待 发 送 的 字符 
描述 该 函数 返回 一 个 指示 接收 FIFO 中 是 否 有 数据 的 标志 
返回 参数 如 果 在 接收 FIFO 中 有 数据 则 返回 bue; 若 在 接収 FIFO 中 没有 数据 ， 则 返回 false 
表 A-12 UARTClockSourceGet 
功能 获取 指定 UART 波 特 率 的 时 钟 源 
函数 原型 uint32_t UARTClockSourceGet (uint32_t ui32Base ) 
参数 ui32Base UART 端口 的 基地 址 
描述 该 函数 返回 指定 UART 波 特 率 时 钟 源 。 可 能 的 波 特 率 时 钟 源 为 系统 时 钟 (UART_CLOCK 
人 _SYSTEM) 或 内 部 精密 振荡 器 (UART_CLOCK_PIOSC) 
返回 参数 无 
表 A-13 UARTClockSourceSet 
功能 设置 指定 UART 波 特 率 的 时 钟 源 
了 i rceSe int3 132 Base 
函数 原型 void UARTClockSourceSet (uint32_t ui32Base, 





uint32_t ui32Source ) 
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ui32Base UART 端口 的 基地 址 

















































































































参数 ui32Source UART 波 特 率 时 钟 源 
该 函数 允许 选择 UART 波 特 率 的 时 钟 源 。 可 能 的 波 特 率 时 钟 源 为 系统 时 钟 (UART_ 
描述 CLOCK_SYSTEM) 或 内 部 精密 振荡 器 (UART_CLOCK_PIOSC) 
更 改 波 特 率 的 时 钟 源 需 重 新 配置 波 特 率 
返回 参数 无 
表 A-14 UARTConfigGetExpClk 
功能 获取 UART 的 当前 配置 
void UARTConfigGetExpClk (uint32_ t ui32Base， 
ee uinB2_t ui32UARTCIk, 
函数 原型 uint32_t *pui32Baud, 
uint32_t *pui32Config) 
ui32Base UART 端口 的 基地 址 
参数 ui32UARTCIk 提供 UART 模块 的 时 钟 速率 
pui32Baud 指向 波 特 率 存 放 単 元 的 指針 
pui32Config 指向 数据 格式 存放 单元 的 指针 
该 函数 确定 UART 的 波 特 率 和 数据 格式 ， 提 供 一 个 显 式 的 外 设 时 钟 (以 ExpClk 为 
后 级 )。 返 回 实际 的 波 特 率 ; 它 可 能 不 是 所 需 的 精确 波 特 率 或 “正式 的 ” 波 特 率 。 
pui32Config 返回 的 数据 格式 与 UARTConfigSetExpClk( ) 的 参数 ui32Config 所 枚挙 的 
相同 
描述 外 设 时 钟 = 处 理 器 时 钟 。 系 统 时 钟 的 频率 是 SysCuClockGet( ) 的 返回 值 ， 或 者 它 为 已 知 
常量 时 ， 其 可 为 显 式 的 硬 编码 
对 于 Tiva 器 件 ， 可 通过 UARTClockSourceSet( ) 指定 UART 波 特 率 的 时 钟 源 ， 外 设 时 钟 可 
以 改变 PIOSC。 在 这 种 情况 下 ， 外 设 时 钟 应 指定 为 16 000 000 
返回 参数 无 
表 A-15 UARTConfigSetExpClk 
功能 设置 UART 的 配置 
void UARTConfigSetExpClk (uint32_t ui32Base, 
i uint32_t ui32UARTCIk, 
函数 原型 uint32_t ui32 Baud , 
uint32_t ni32Config ) 
ui32Base UART 端口 的 基地 址 
参数 ui32UARTClk ”提供 给 UART 模块 的 时 钟 速率 
= ui32Baud ”所 需 的 波 特 率 
ui32Config 端口 (数据 位 数 、 停 止 位 和 奇偶 校 验 ) 的 数据 格式 
该 函数 配置 UART， 使 其 运行 在 指定 的 数据 格式 下 。ui32Baud 参数 提供 波 特 率 ， 
ui32 Config 参数 配置 数据 格式 。 且 ui32Config 是 数据 位 、 停 止 位 、 奇 偶 校 验 位 这 三 个 值 的 逻 
辑 或 。 
描述 > 数据 位 : 
HS る UART_CONFIC_WLEN_8 //8 位 数据 
る UART_CONFIG_ WLEN_7 //7 位 数据 
ぐ UART_CONFIG_WLEN_6 //6 位 数据 
る UART_CONFIG_ WLEN_5 //5 位 数据 
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> 停止 位 : 
ぐ UART_CONFIG_STOP_ONE //1 个 停止 位 
ぐ UART_CONFIC_STOP_TWO //2 个 停止 位 
> 奇偶 校 验 位 
描述 る UART_CONFIG_PAR_NONE // 无 奇偶 校 验 位 
る UART_CONFIG_PAR_EVEN // 偶 校 验 位 
UART_CONFIG_PAR_ODD // 奇 校 验 模 
る UART_CONFIG_PAR_ONE //1 个 奇偶 校 验 位 
ぐ UART_CONFIG_PAR_ZERO // 校 验 位 始终 为 0 
返回 参数 无 
表 A-16 UARTDisable 
功能 禁止 发 送 和 接收 
函数 原型 void UARTDisable (uint32_t ui32Base) 
参数 ui32Base UART 端口 的 基地 址 
描述 该 函数 禁止 UART， 等 待 当前 字符 发 送 结 束 ， 并 刷新 发 送 FIFO 
返回 参数 无 
表 A-17 UARTDisableSIR 
功能 禁止 指定 UART 的 SIR (DA) 模式 
函数 原型 void UARTDisableSIR (uint32_t ui32 Base ) 
参数 ui32Base UART 端口 的 基地 址 
此 函数 禁止 UART 的 SIR (rDA) 模式 , 清 除 SIREN (IRDA) 和 SIRLP 位 〈 低 功率 ) 
该 函数 只 在 UART 由 UARTEnable( ) 函数 使 能 前 有 效 ， 因 此 在 调用 UARTEnableSIR( ) 之 
描述 前 ， 必 须 先 行 调 用 UARTConfigSetExpClk ( ) ， 因 为 UARTConfigSetExpClk ( ) 函数 需 调 用 
I UARTEnable( ) 函数 
另 一 种 选择 是 先 调 用 UARTDisable( ) ， 其 次 调用 UARTEnableSIR( ) ， 然 后 通过 调用 
UARTEnable( ) 使 能 UART 
返 回 参 数 无 
表 A-18 UARTDMADisable 
功能 禁止 UART DMA 操作 
kt 電 | void UARTDMADisable (uint32_t ui32Base , 
函数 原型 uint32_t ui32DMAFlags ) 
参数 ui32Base UART 端口 的 基地 址 
a ui32DMAFlags 禁止 DMA 功能 的 位 屏蔽 
该 函数 用 于 禁止 UARTDMAEnable ( ) 使 能 的 UART DMA 功能 。 禁 止 指 定 的 UART DMA 
功能 。 而 参数 ui32DMAFlags 为 下 列 任意 值 的 逻辑 或 : 
描述 > UART_DMA_RX // 禁 止 DMA 接收 
> UART DMA_TX // 禁 止 DMA 传输 
> UART_DMA_ERR_RXSTOP// 当 UART 发 生 错 误 时 不 禁止 DMA 接收 
返回 参数 无 
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表 A-19 UARTDMAEnable 






























































































































































功能 使 能 UART DMA 操作 
本 Void UARTDMAEnable (uint32_t ui32 Base 
5 型 ， 
函数 原型 uint32_t ui32DMAFlags ) 
参 数 ui32Base UART 端口 的 基地 址 
ui32DMAFlags 禁止 DMA 功能 的 位 屏蔽 
使 能 指定 的 UART DMA 功能 。UART 可 配置 成 使 用 DMA 发 送 或 接收 ， 以 及 如 果 发 生 错 
误 时 禁止 接收 。 而 参数 ui32DMAFlags 为 下 列 任意 值 的 逻辑 或 : 
描述 > UART_DMA_RX // 使 能 DMA 接收 
> UART_DMA_TX // 使 能 DMA 传输 
> UART_DMA_ERR_RXSTOP // 当 UART 发 生 错 误 时 不 禁止 DMA 接收 
返回 参数 元 
表 A-20 UARTEnable 
功能 使 能 发 送 和 接收 
函数 原型 void UARTEnable (uint32_t ui32 Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 使 能 UART， 以 及 其 发 送 和 接收 FIFO 
返回 参数 无 
表 A-21 UARTEnableSIR 
功能 使 能 指定 的 UART 的 SIR (hrDA) 模式 
7 四 電 | void UARTEnableSIR (uint32_t 32Base , 
函数 原型 bool bLowPower) 
参数 ui32Base UART 端口 的 基地 址 
= bLowPower 指示 SIR 的 低 功 耗 模式 是 否 被 使 用 
该 函数 使 能 SIR (rDA) 模式 的 SIREN 控制 位 。 如 果 bLowPower 标志 置 位 ， 则 打开 SIR 
低 功 耗 模式 (SIRLP 位 会 被 置 位 ) 
该 函数 只 在 UART 由 UARTEnable( ) 函数 使 能 前 有 效 ， 因 此 在 调用 UARTEnableSIR( ) 之 
描述 前 ， 必 须 先 行 调 用 UARTConfigSetExpClk ( ) ， 因 为 UARTConfigSetExpClk ( ) 函数 需 调 用 
UARTEnable( ) 函数 
另 一 种 选择 是 先 调 用 UARTDisable( ) ， 其 次 调用 UARTEnableSIR ( ) ， 然 后 通过 调用 
UARTEnable( ) 使 能 UART 
返 回 参 数 无 
表 A-22 UARTFIFODisable 
功能 禁止 发 送 和 接收 FIFO 
函数 原型 void UARTFIFODisable (uint32_t mi32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 禁止 UART 中 的 发 送 和 接收 FIFO 
返回 参数 无 
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表 A-23 UARTFIFOEnable 

































































































































































功能 使 能 发 送 和 接收 FIFO 
函数 原型 void UARTFIFOEnable (uint32_t mi32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 使 能 UART 中 的 发 送 和 接收 FIFO 
返回 参数 无 
表 A-24 UARTFIFOLevelGet 
功能 获取 产生 中 断 时 的 FIFO 深度 
void UARTFIFOLevelGet (uint32_t ui32 Base , 
函数 原型 uint32_t * pui32TxLevel , 
uint32_t * pui32RxLevel) 
ui32Base UART 端口 的 基地 址 
pui32TxLevel 指向 发 送 FIFO 存储 单元 深度 的 指针 ， 返 回 下 列 值 之 一 : 
> UART_FIFO_TX1_8 // 在 1/8 深度 MI 断 
> UART_FIFO_TX2_8 // 在 1/4 深度 时 产生 发 送 中 断 
> UART_FIFO_TX4 8 // 在 1/2 深度 时 产生 发 送 中 断 
> UART_FIFO_TX6_8 // 在 3/4 深度 时 产生 发 送 中 断 
参数 > UART_FIFO_TX7_8 // 在 7/8 深度 时 产生 发 送 中 断 
pui32RxLevel 指向 接收 FIFO 深度 存储 单元 的 指针 ， 返 回 下 列 值 之 一 : 
> UART_FIFO_RX1 8 // 在 1/8 深度 时 产生 接收 中 断 
> UART_FIFO_RX2_8 // 在 144 深度 时 产生 接收 中 断 
> UART_FIFO_RX4 8 // 在 1/2 深度 时 产生 接收 中 断 
> UART_FIFO_RX6_8 // 在 3/4 深度 时 产生 接收 中 断 
> UART_FIFO_RX7_8 // 在 7/8 深度 时 产生 接收 中 断 
描述 这 个 函数 获取 在 产生 发 中 断 时 送 和 接收 的 FIFO 深度 
返回 参数 无 
表 A-25 UARTFIFOLevelSet 
功能 设置 产生 中 断 时 的 FIFO 深度 
void UARTFIFOLevelSet (uint32_t ui32Base， 
函数 原型 uint32_t uni32TxLevel, 
uint32_t ni32RxLevel ) 
ui32Base UART 端口 的 基地 址 
ui32TxLevel 发 送 中 断 的 FIFO 深度 ， 其 值 为 如 下 之 一 : 
> UART_FIFO_TX1_ 8 ”// 在 1/8 深度 时 产生 发 送 中 断 
> UART_FIFO_TX2 8 ”// 在 1/4 深度 时 产生 发 送 中 断 
> UART_FIFO_TX4 8  // 在 122 深度 时 产生 发 送 中 断 
> UART_FIFO_TX6 8  // 在 3/4 深度 时 产生 发 送 中 断 
参数 > UART_FIFO_TX7 8  // 在 7/8 深度 时 产生 发 送 中 断 
ui32RxLevel 接収 中 断 的 FIFO 深度 ， 取 值 为 下 列 之 一 : 
> UART_FIFO_RX1 8 ”// 在 1/8 深度 时 产生 接收 中 断 
> UART_FIFO_RX2 8 ”// 在 1/4 深度 时 产生 接收 中 断 
> UART_FIFO_RX4 8 ”// 在 1/2 深度 时 产生 接收 中 断 
> UART_FIFO_RX6_ 8 ”// 在 3/4 深度 时 产生 接收 中 断 
> UART_FIFO_RX7_8 ”// 在 7/8 深度 时 产生 接收 中 断 
描述 该 函数 用 于 配置 在 产生 中 断 时 发 送 和 接收 的 FIFO 深度 
返回 参数 无 
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表 A-26 
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功能 返回 正在 使 用 的 UART 硬件 流 控制 模式 
函数 原型 uint32_t UARTFlowControlGet ( uint32_t ui32 Base ) 
参数 ui32Base UART 端口 的 基地 址 
描述 该 函数 用 于 返回 当前 的 硬件 流 控制 模式 
返回 参数 返回 当前 使 用 的 流 控制 模式 。 返 回 值 是 UART_FLOWCONTROL_TX ( 若 硬件 发 送 流 CTS 
ー 被 使 能 ) 、UART_FLOWCONTROL_RX ( 若 便 件 接収 流 RTS 被 使 能 ) 的 逻辑 或 
表 A-27 UARTFlowControlSet 
功能 设置 使 用 的 UART 硬件 流量 控制 模式 
- 尖 奋 刑 | void UARTFlowControlSet (uint32_t ui32Base, 
函数 原型 uint32_t ui32Mode) 
ui32Base UART 端口 的 基地 址 
参数 ui32Mode ”使 用 的 流 控 制 模式 。 这 个 参数 为 UART_ FLOWCONTROL_TX 与 UART_FLOW- 
和 CONTROL_RX 的 逻辑 或 ， 如 果 禁 止 硬件 流 ， 则 该 参数 为 UART_FLOWCONTROL_NONE 
(禁止 硬件 流 控制 ) 
该 函数 配置 所 需 的 硬件 流 控制 模式 。 如 果 ui32Mode 中 包含 UART_FLOWCONTROL_TX 
标志 ， 如 果 输 入 的 CTS 信号 有 效 ， 则 只 可 发 送 数据 
描述 若 ui32Mode 包含 UART_FLOWCONTROL_RX 标志 ， 只 有 当 存 在 接收 FIFO 的 可 用 空间 
时 ，RTS 输出 才 由 硬件 控制 。 如 果 没 有 所 需 的 硬件 流量 控制 ， 则 应 传递 UART_FLOWCON- 
TROL_NONE 
返 回 参 数 无 
表 A-28 UARTIntClear 
功能 清除 UART 中 断 来 源 
-类 fj 芷 電 | void UARTIntClear (uint32_t ui32Base， 
函数 原型 uint32_t ui32IntFlags ) 
参数 ui32Base UART 端口 的 基地 址 
ui32IntFlags ”被 清除 中 断 源 的 位 屏蔽 
描述 清除 指定 UART 的 中 断 源 ， 使 其 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 调用 ， 以 防止 在 
退出 时 中 断 再 次 被 触发 
返回 参数 无 
表 A-29 UARTIntDisable 
功能 禁止 单个 UART 中 断 源 
本 Void UARTIntDisable (uint32_t ui32 Base 
5 型 ， 
函数 原型 uint32_t ui32IntFlags ) 
参数 u32Base UART 端口 的 基地 址 
ui32 IntFlags 禁止 中 断 源 的 位 屏蔽 
描述 该 函数 禁止 指示 的 UART 中 断 源 。 只 有 使 能 的 中 断 源 才 会 反映 到 处 理 器 中 断 ， 禁 止 的 中 
用 还 断 源 对 处 理 器 无 影响 。 其 中 ， 参 数 ui32IntFlags 与 UARTIntEnable( ) 函数 中 的 参数 定义 相同 
返回 参数 无 
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表 A-30 UARTIntEnable 


















































































































































功能 使 能 单个 UART 中 断 源 
本 埋 void UARTIntEnable ( uint32_t um32 Base , 
落 数 原型 uint32_t ui32IntFlags ) 
参数 ui32Base UART 端口 的 基地 址 
和 ui32IntFlags ”使 能 中 断 源 的 位 掩 码 
该 函数 使 能 指示 的 UART 中 断 源 
参数 ui32IntFlags 为 下 列 任意 值 的 逻辑 或 : 
UART_INT_9BIT //9 位 地 址 匹配 中 断 
UART_INT_OE // 江 出 错误 中 断 
UART_INT_BE /人 /中 止 错误 中 断 
UART_INT PE // 奇 偶 错 误 中 断 
描述 UART_INT_FE // 帧 错误 中 断 
ee UART INT RT 接収 超 時 中 断 
UART_INT_TX // 发 送 中 断 
UART_INT_RX // 接 収 中 断 
UART_INT_DSR //DSR 中 断 
UART INT_DCD //DCD 中 断 
UART_INT_CTS //CTS 中 断 
UART_INT_RI //RI 中 出 
返回 参数 无 
表 A-31 UARTIntRegister 
功能 注册 UART 的 中 断 处 理 程序 
-光正 刑 void UARTIntRegister (uint32_t ui32Base， 
函数 原型 void ( * pfnHandler) (void)) 
参数 ui32Base UART 端口 的 基地 址 
多 pfnHandler 指向 UART 中 断 发 生 时 被 调 函 数 的 指针 
描述 该 函数 注册 中 断 处 理 程序 。 该 函数 使 能 中 断 控制 器 中 的 全 局 中 断 ， 特 定 的 UART 中 断 必 
A 须 通 过 UARTIntEnable ( ) 函数 使 能 。 且 由 中 断 处 理 程序 来 负责 清除 中 断 源 
返回 参数 无 
表 A-32 UARTIntStatus 
功能 获取 当前 的 中 断 状态 
ー uint32_t UARTIntStatus ( uint32_t ui32 Base , 
函数 原型 bool bMasked ) 
ui32Base UART 端口 的 基地 址 
参数 bMasked ”车 所 需 的 是 原始 中 断 状态 ， 则 bMasked 为 false; 若 所 需 的 是 屏蔽 的 中 断 状态 ， 
则 bMasked 为 true 
描述 该 函数 返回 指定 的 UART 中 断 状 态 。 无 论 是 原始 中 断 状态 还 是 允许 中 断 反映 到 处 理 器 的 
状态 ， 都 可 以 被 返回 
返回 参数 返回 当前 中 断 状 态 ， 描 述 在 UARTIntEnable( ) 中 枚 举 位 字段 的 值 
表 A-33 UARTIntUnregister 
功能 注销 UART 中 断 的 中 断 处 理 程序 
函数 原型 void UARTIntUnregister (uint32_t ui32 Base ) 
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参数 ui32Base UART 端口 的 基地 址 
描述 该 函数 注销 中 断 处 理 程序 ， 清 除 UART 中 断 发 生 时 被 调用 的 处 理 程序 。 它 也 会 关闭 中 断 
es 控制 器 中 的 中 断 ， 使 中 断 处 理 程序 不 会 被 再 调 
返回 参数 无 
表 A-34 UARTModemControlClear 
功能 清除 DTR 和 /或 RTS 调制 解 调 器 控制 信号 的 状态 
る 7 本 人 void UARTModemControlClear (uint32_t ni32 Base , 
函数 原型 uint32_t ui32Control ) 
参数 u32Base UART 端口 的 基地 址 
< ui32Control ”表示 调制 解 调 器 控制 位 置 位 的 位 映射 标志 
此 函数 清除 UART 中 DTR 或 RTS 调制 解 调 器 的 握手 输出 状态 
描述 参数 ui32Control 为 下 列 值 的 逻辑 或 : 
He > UART_OUTPUT_DTR ”// 调 制 解 调 器 的 DTR 控制 信号 
> UART_OUTPUT_RTS // 调 制 解 调 器 的 RTS 控制 信号 
返回 参数 无 
表 A-35 UARTModemControlGet 
功能 获取 DTR 和 RTS 调制 解 调 器 控制 信号 的 状态 
7 四 | void UARTModemControlClear (uint32_t ni32Base , 
函数 原型 uint32_t ui32Control ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 返回 两 个 UART 调制 解 调 器 控制 信号 (DTR、 RTS) 的 当前 状态 
由 返回 握手 输出 信和 号 的 状态 。 它 为 UART_OUTPUT_RTS 与 UART_OUTPUT_DTR 组 合 逻 辑 
返回 参数 ルー 
或 的 人 
表 A-36 UARTModemControlSet 
功能 设置 DTR 和 /或 RTS 调制 解 调 器 控制 信号 的 状态 
着 四 弄 void UARTModemControlSet ( uint32_t um32 Base , 
函数 原型 uint32_t ui32Control ) 
参数 ui32 Base UART 端 的 基地 址 
< ui32Control ”表示 调制 解 调 器 控制 位 被 置 位 的 位 映射 标志 
该 函数 配置 UART 中 DTR 或 RTS 调制 解 调 器 握手 输出 的 状态 
描述 参数 ui32Control 为 下 列 值 的 逻辑 或 : 
> UART_OUTPUT_DTR ”// 调 制 解 调 器 的 DTR 控制 信号 
> UART_OUTPUT_RTS // 调 制 解 调 器 的 RTS 控制 信号 
返回 参数 无 
表 A-37 UARTModemStatusGet 
功能 获取 RI、DCD、DSR 和 CTS 调制 解 调 器 状态 信和 号 的 状态 
函数 原型 uint32 t UARTModemStatusGet ( uint32_t ui32 Base ) 
参 数 u32Base UART 端口 的 基地 址 
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描述 该 函数 返回 UART 中 4 个 调制 解 调 器 状态 信号 (RI、DCD、DSR、CTS) 的 当前 状态 
反 回 参数 返回 握手 输出 信号 的 状态 。 此 值 为 UART_INPUT_RI、UART_INPUT_DCD、UART_IN- 
ーー PUT_CTS 和 UART_ INPUT_DSR 的 组 合 逻 辑 或 
表 A-38 UARTParityModeGet 
功能 获取 正在 使 用 中 的 校 验 类 型 
函数 原型 uint32_t UARTParityModeGet (uint32_t 32 Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 用 于 获取 传输 数据 和 和 希望 的 接收 数据 的 校 验 的 类 型 
返回 当前 的 奇偶 校 验 设置 。 其 取 值 为 下 列 值 之 一 : 
> UART_CONFIG_PAR_NONE ” // 无 校 验 位 
n TS 
返回 参数 > UART_CONFIG_PAR_EVEN // 偶 校 验 
> UART CONFIG_PAR_ODD // 奇 校 验 
> UART_CONFIG_PAR_ONE // 校 验 位 始终 为 1( 可 直接 控制 校 验 位 ) 
> UART_CONFIG_PAR_ZERO // 校 验 位 始终 为 0( 可 直接 控制 校 验 位 ) 
表 A-39 UARTParityModeSet 
功能 设置 校 验 类 型 
| 下 void UARTParityModeSet (uint32_t ui32Base , 
函数 原型 uint32_t ui32Parity ) 
参数 ui32Base UART 端口 的 基地 址 
ー u32Parity 指定 使 用 的 校 验 类 型 
该 函数 用 于 配置 发 送 和 希望 接收 的 校 验 类 型 
参数 ui32Parity 的 取 值 必须 为 下 列 值 之 一 : 
> UART_CONFIG_PAR_NONE ” // 无 校 验 位 
描述 > UART_CONFIG_PAR_EVEN ” // 偶 校 验 
> UART_CONFIG_PAR_ODD // 奇 校 验 
> UART_CONFIG_PAR_ONE // 校 验 位 始终 为 1 (可 直接 控制 校 验 位 ) 
> UART_CONFIG_PAR_ZERO ”// 校 验 位 始终 为 0 (可 直接 控制 校 验 位 ) 
返回 参数 无 
表 A-40 UARTRxErrorClear 
功能 清除 所 有 报告 的 接收 器 错误 
函数 原型 void UARTRxErrorClear (uin132_ t ui32 Base ) 
参 数 ui32Base UART 端口 的 基地 址 
该 函数 用 于 清除 所 有 接收 需 错 误 标 志 的 报告 ， 这 些 错 误 标志 可 以 通过 UARTRxErrorGet( ) 
描述 得 到 。 如 果 使 用 溢出 、 帧 错误 、 校 验 错误 或 打 断 中 断 ， 那 么 清除 中 断后 必须 调用 此 函数 ， 以 
确保 后 面 的 同类 型 错误 可 触发 男 一 次 中 断 
返回 参数 无 
表 A-41 UARTRxErrorGet 
功能 获取 当前 接收 器 错误 
函数 原型 uint32_t UARTRxErrorGet ( uint32_t ui32Base ) 
参数 ui32Base UART 端口 的 基地 址 
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该 函数 返回 4 个 接收 器 错误 源 各 自 的 当前 状态 。 通 过 前 一 次 调用 UARTCharGet( ) 或 
描述 UARTCharGetNonBlocking( ) ， 返 回 的 错误 就 相等 于 返回 4 个 错误 位 。 除 非 溢 出 错误 被 设置 
成 立即 发 生 ， 而 不 是 在 下 一 次 读 取 一 个 字符 时 才 发 生 
返回 参数 返回 接收 错误 标志 为 UART_RXERROR_FRAMING、 UART_RXERROR_PARITY 、UART_ 
加 RXERROR_BREAK、UART_RXERROR_OVERRUN) 的 组 合 逻 辑 或 
表 A-42 UARTSmartCardDisable 
功能 禁止 指定 UART 的 ISO7816 智能 卡 模式 
函数 原型 void UARTSmartCardDisable (uint32_t ui32Base) 
参数 ui32Base UART 端口 的 基地 址 
描述 该 函数 清除 UART 控制 寄存 器 的 SMART 位 (1SO7816 智能 卡 ) 
返回 参数 无 
表 A-43 UARTSmartCardEnable 
功能 使 能 指定 UART 的 ISO7816 智能 卡 模式 
函数 原型 void UARTSmartCardEnable (uint32_t ui32 Base ) 
参 数 u32Base UART 端口 的 基地 址 
描述 该 函数 使 能 UART 中 的 SO7816 智能 卡 模式 的 SMART 控制 位 
RS 其 中 ，IS07816 要 求 字 长 为 8 位 和 偶 校 验 
返回 参数 无 
表 A-44 UARTSpaceAvail 
功能 确定 发 送 FIFO 中 是 否 有 可 用 的 空间 
函数 原型 bool UARTSpaceAvail (uint32_t ui32Base ) 
参 数 ui32Base UART 端口 的 基地 址 
描述 该 函数 返回 一 个 指示 发 送 FIFO 是 否 有 可 用 空间 的 标志 
如 果 发 送 FIFO 中 有 可 用 的 空间 ， 则 返回 true; 如 果 发 送 FIFO 中 无 可 用 的 空间 ， 则 返 
返回 参数 
回 false 
表 A-45 UARTTxIntModeGet 
功能 返回 UART 发 送 中 断 的 当前 操作 模式 
函数 原型 uint32_t UARTTxIntModeGet ( uint32_t ui32Base) 
参 数 ui32Base UART 端口 的 基地 址 
该 函数 返回 UART 发 送 中 断 的 当前 的 操作 模式 
返回 值 如 下 : 
描述 > UART_TXINT_MODE_EOT // 如 果 当 前 配置 的 发 送 中 断 有 效 ， 一 旦 发 送 器 完全 处 于 闲 
置 状态 ， 将 返回 UART_TXINT_MODE_EOT 
> UART_TXINT_MODE_FIFO // 根 据 发 送 FIFO 的 深度 ， 如 果 中 断 配置 有 效 ， 将 返回 
UART_TXINT_MODE_FIFO 
返回 参数 返回 UART_TXINT_MODE_FIFO 或 UART TXINT_MODE_EOT 
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表 A-46 UARTTxIntModeSet 
























































功能 设置 UART 发 送 中 断 的 操作 模式 
一 六 | void UARTTxIntModeSet (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Mode) 
u32Base UART 端口 的 基地 址 
参数 ui32Mode ui32Mode 是 发 送 中 断 的 操作 模式 。 如 果 为 UART_TXINT_MODE_EOT, 別当 
发 送 器 为 空 时 触发 中 断 ， 如 果 为 UART_TXINT_MODE_FIFO， 则 根据 发 送 FIFO 的 深度 去 触 
发 中 断 
函数 允许 设置 UART 传输 中 断 的 模式 。 默 认 情 况 下 ， 当 FIFO 深度 处 于 阅 值 内 时 可 申请 
描述 一 个 发 送 中 断 (调用 UARTFIFOLevelSet( ) 函数 完成 阔 值 设置 )。 或 者 ， 如 果 调 用 这 个 函数 
Ee (在 参数 wi32Mode 设置 成 UART_TXINT_MODE_EOT 时 ) ， 则 一 旦 发 送 器 完全 处 于 空闲 状 
态 ， 将 发 出 一 个 发 送 中 断 请 求 
返回 参数 无 
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第 4 章 附录 ADC 固件 库 函 数 简介 


本 童 附录 将 简要 介绍 ADC 固件 库 函 数 的 参数 定义 及 功能 说 明 。 


表 B-1 ADCBusy 















































































































































功能 确定 ADC 是 否 为 忙 状态 
函数 原型 bool ADCBusy (uint32_t ui32 Base ) 
参 数 ui32Base ADC 模块 基地 址 
该 函数 允许 调用 者 确定 是 否 当前 采样 ADC。 如 果 返 回 false， 则 ADC 未 在 采样 数据 。 让 
描述 设备 进入 深度 睡眠 之 前 ， 使 用 此 函数 来 检测 ADC 数据 采样 的 完成 。 在 使 用 该 函数 前 ， 强 
Ne 烈 建议 将 所 有 使 能 的 序列 发 生 器 的 事件 触发 改 为 ADC_TRIGCER_NEVER， 以 防止 在 检查 
到 忙 状 态 后 启动 ADC 采样 
返回 如果 ADC 正在 进行 采样 ， 则 返回 tae, 如果 ADC 采样 完成 ， 才 返回 false 
表 B-2 ADCComparatorConfigure 
功能 配置 ADC 的 数字 比较 器 
void ADCComparatorConfigure (uint32_t ui32Base, 
函数 原型 uint32_t ui32Comp, 
uint32_t ui32Config) 
ui32Base ADC 模块 基地 址 
参数 ui32Comp 配置 比较 器 的 索引 
ui32Config ”比较 右 的 配置 
该 函数 用 于 配置 比较 器 。 参 数 ui32Config 为 ADC_COMP_TRIG_xxx 与 ADC_COMP_INT_ 
xxx 的 逻辑 或 
① ADC_COMP_TRIG_xxx 可 取 以 下 的 值 : 
> ADC_COMP_TRIG_NONE // 不 触发 PWM 故障 条件 
描述 > ADC_COMP_TRIG_LOW_ALWAYS // 当 ADC 输出 处 于 低频 带 时 ， 将 触发 PWM 故障 
条 件 
> ADC_COMP_TRIG_LOW _ONCE // 当 ADC 输出 至 低频 带 时 ， 会 触发 一 次 PWM 故障 
条 件 





> ADC_COMP_TRIG_LOW_HALWAYS // 仅 当 自 上 次 的 触发 输出 ADC 输出 已 经 在 高 频 
段 ， 当 ADC 输出 至 低频 段 时 ， 总 是 会 触发 PWM 故障 条 件 
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> ADC_COMP_TRIG_LOW_HONCE // 仅 当 自 上 次 的 触发 输出 ADC 输出 已 经 在 高 频段 ， 


当 ADC 输出 至 低频 段 时 ， 








会 触发 一 次 PWM 故障 条 件 


> ADC_COMP_TRIG_MID_ALWAYS // 当 ADC 输出 处 于 中 频段 时 ， 总 是 会 触发 PWM 错 


误 条 件 








> ADC_COMP_TRIG_MID_ONCE // 当 ADC 输出 转换 至 中 频段 时 ， 将 触发 一 次 PWM 错 


误 条 件 


> ADC_COMP_TRIG_HIGH_ALWAYS // 当 ADC 输出 处 于 


误 条 件 





高 频段 时 ， 总 是 触发 PWM 错 


> ADC_COMP_TRIG_HIGH_ONCE // 当 ADC 输出 至 高 频段 时 ， 会 触发 一 次 PWM 错误 


条 件 
> ADC_COMP_TRIC_H 
ADC 输出 至 高 频段 时 


> ADC_COMP_TRIG_HIGH_HONCE // 如 果 自 上 
将 会 触发 一 次 PWM 错误 条 件 


ADC 输出 至 高 频段 时 ， 


IGH_HALWAYS 
， 总 是 会 触发 PWM 


@ ADC_COMP_INT_xxx 的 取 值 如 下 ， 


> ADC_COMP_INT_NO 





NE // 不 产生 ADC 





> ADC_COMP_INT LOW_ALWAYS // 当 
> ADC_COMP_INT_LOW_ONCE // 当 ADC 输出 低频 段 时 ， 将 会 产生 一 次 ADC 中 断 


> ADC_COMP_INT_ LOW_ HALWAYS // 如 果 自 上 一 次 触发 ADC 输出 已 在 高 频段 ， 当 
ADC 输出 至 低频 段 时 





， 总 是 会 产生 ADC 


> ADC_COMP_INT_LOW_HONCE // 如 果 

输出 至 低频 段 时 ， 将 产生 一 次 ADC 中 断 
> ADC_COMP_INT_MID_ALWAYS // 当 ADC 输出 中 频段 时 ， 将 产生 ADC 中 断 
> ADC_COMP_INT_MID_ONCE // 当 ADC 输 
> ADC_COMP_INT_HIGH_ALWAYS // 当 ADC 输出 高 频段 时 ， 将 产生 ADC 中 断 


> ADC_COMP_INT_HIGH_ONCE 


> ADC_COMP_INT_HIGH_HALWAYS //# 


ADC 输出 至 高 频段 时 








> ADC_COMP_INT_HIGH_HONCE // 如 果 
ADC 输出 至 高 频段 时 ， 


， 总 是 会 产生 ADC 








将 产生 一 次 ADC 





// 如 果 自 上 一 次 触发 ADC 输出 已 在 低频 段 ， 当 





错误 条 件 











一 次 触发 ADC 输出 已 在 低频 段 ， 当 


中 断 
ADC 输出 低频 段 时 ， 将 产生 ADC 中 断 














中 断 
自 上 一 次 触发 ADC 输出 已 在 高 频段 ， 当 ADC 











出 中 频段 时 ， 将 产生 一 次 ADC 中 断 





// 当 ADC 输出 高 频段 时 ， 将 会 产生 一 次 ADC 中 断 





[ 果 自 上 一 次 触发 ADC 输出 已 在 低频 段 ， 当 
中 断 
自 上 一 次 触发 ADC 输出 已 在 低频 段 ， 只 有 当 
中 断 

















岗 
回 





功能 


无 


表 B-3 ADCComparatorIntClear 
青 除 采样 序列 比较 器 的 中 断 源 





函数 原型 


void ADCComparatorIntClear (uint32_t ui32Base， 
uint32_t ui32Status ) 





ui32Base ADC 模块 基地 址 
ui32Status 清除 位 映射 的 中 断 状态 





清除 指定 的 中 断 状态 








功能 


品 


表 B-4 ADCComparatorIntDisable 


禁止 采样 序列 比较 器 中 


断 





函数 原型 


void ADCComparatorIntDisable (uint32_t ui32 Base , 
uint32_t m32SequenceNum ) 





ui32Base ADC ADC 模块 基地 址 


ui32SequenceNum 采 档 


半 序 列 号 








数 禁 止 请 求 采 样 序列 比较 器 的 中 断 








所 
加 








无 


表 B-5 ADCComparatorIntEnable 




















































































































功能 使 能 采样 序列 比较 器 中 断 
7 古 刑 void ADCComparatorIntEnable (uint32_t ui32Base, 
函数 原型 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
ui32SequenceNum ”采样 序列 号 
描述 该 函数 使 能 请 求 采样 序列 比较 器 的 中 断 
返回 无 
表 B-6 ADCComparatorIntStatus 
功能 获得 采样 序列 比较 器 中 断 状态 
函数 原型 uint32_t ADCComparatorIntStatus (uint32_t ui32Base ) 
参 数 ui32Base ADC 模块 基地 址 
描述 该 函数 返回 数字 比较 器 中 断 状 态 位 。 该 状态 是 序列 未 知 的 
返回 当前 比较 器 的 中 断 状态 
表 B-7 ADCComparatorRegionSet 

功能 定义 ADC 数字 比较 器 区 域 

void ADCComparatorRegionSet (uint32_t ui32Base， 
妇 铸 丰 型 uint32_t ui32Comp, 
汕 数 原型 uint32_t ui32LowRef, 

uint32_t ui32HighRef ) 

ui32Base ADC 模块 基地 址 
参数 ui32Comp ”比较 器 配置 索引 
= ui32LowRef 低 中 频 阔 值 基准 点 

ui32HighRef 高 中 频 阔 值 基准 点 

ADC 数字 比较 器 的 操作 是 基于 三 个 ADC 值 的 区 域 : 
描述 low - band: 表示 ADC 的 值 生 ui32LowRef 的 值 
MS mid - band: 表示 m32LowRef 值 <ADC 值 三 ui32HighRef 值 

high -band: 表示 ADC 值 >=ui32HighRef 的 值 
返回 无 

表 B-8 ADCComparatorReset 

功能 复位 ADC 数字 比较 器 条 件 

void ADCComparatorReset (uint32_t ui32Base， 
7 | uint32_t ui32Comp , 
函数 原型 bool bTrigger, 

bool blInterrupt) 

ui32 Base ADC 模块 基地 址 
参数 ui32Comp 比较 器 索引 
6 bTrigger 指示 复位 触发 条 件 的 标志 

bInterrupt ”指示 复位 中 断 条 件 的 标志 
描述 由 于 数字 比较 器 要 使 用 当前 和 以 前 的 ADC 值 ， 该 函数 允许 比较 器 复位 到 它 的 初始 值 以 

防止 当 一 个 序列 使 能 时 使 用 过 时 的 数据 

返回 无 
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表 了 -9 ADCHardwareOversampleConfigure 





























































































































































































































功能 配置 ADC 硬件 过 采样 因子 
る 7 本 電 void ADCHardwareOversampleConfigure (uint32_t ni32 Base , 
函数 原型 uint32_t ui32Factor ) 
参 数 ui32Base ADC 模块 的 基地 址 
ui32Factor ” 待 平均 的 采样 数 
该 函数 为 ADC 配置 硬件 过 采样 因子 ， 可 用 于 提高 采样 数据 的 分 辨 率 。 过 采样 是 通过 平 
均 多 个 样本 相同 的 模拟 输入 。 硬 件 过 采样 支持 2x、4x、8x、16x、32x 和 64x 六 种 过 采样 
描述 率 ， 若 指定 过 采样 因子 为 0， 则 将 禁止 硬件 过 采样 。 硬 件 过 采样 的 配置 对 所 有 采样 序列 都 
有 效 。 硬 件 过 采样 不 会 像 软件 过 采样 那样 ， 降 低 采样 序列 的 深度 ， 每 个 写 入 采样 序列 发 生 
器 FIFO 中 的 采样 值 是 完全 过 采样 的 模拟 输入 读数 
使 能 硬件 平均 采样 值 虽然 可 提高 ADC 的 精确 度 ， 但 是 以 增加 采样 的 吞吐 量 为 代价 的 
返回 无 
表 B-10 ADCIntClear 
功能 清除 采样 序列 的 中 断 源 
二 六 1 void ADCIntClear (uint32_t ui32Base， 
蚂 数 原型 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
向 ui32SequenceNum 采样 序列 号 
描述 清除 指定 采样 序列 的 中 断 源 ， 使 其 失效 。 该 函数 必须 在 中 断 处 理 程序 中 调用 ， 以 防止 在 
退出 时 再 次 立即 触发 中 断 
返回 无 
表 B-11 ADCIntClearEx 
功能 清 除 指定 ADC 中 断 源 
ーー void ADCIntClearEx (uint32_t ui32Base, 
蚂 数 原型 uint32_t ui32IntFlags ) 
参数 ui32Base ADC 模块 基地 址 
ui32IntFlags ”禁止 中 断 源 的 位 掩 码 
描述 清 除 指定 中 断 源 的 中 断 。 基 中 , ui32IntFlags 参数 是 ADC_INT_ * 值 的 逻辑 或 
返 回 无 
表 B-12 ADCImtDisable 
功能 禁止 采样 序列 中 断 
る 7 本 人 void ADCIntDisable (uint32_t ui32 Base , 
函数 原型 uint32_t ui32SequenceNum ) 
参 数 ui32Base ADC 模块 基地 址 
= ui32SequenceNum 采样 序列 号 
描述 该 函数 用 来 禁止 请 求 的 采样 序列 中 断 
返回 无 
表 B-13 ADCIntDisableEx 
功能 禁止 ADC 中 断 源 
函数 原型 void ADCIntDisableEx (uint32_t ui32Base, 





uint32_t ui32IntFlags ) 

































































参数 ui32Base ADC 模块 基地 址 
ui32IntFlags 禁止 中 断 源 的 位 挫 偽 
该 函数 禁止 指定 的 ADC 中 断 源 
参数 ui32IntFlags 为 任意 下 值 的 逻辑 或 : 
> ADC_INT_SS0 //ADC 采样 序列 0 中 断 
> ADC_INT_SS1 
> ADC_INT_SS2 
> ADC_INT_SS3 
描述 > ADC_INT_DMA_SS0 //DMA 对 ADC 采样 序列 0 的 中 断 
i > ADC_INT_DMA_SS1 
> ADC_INT_DMA_SS2 
> ADC_INT_DMA_SS3 
> ADC_INT_DCON_SS0 /数字 比较 器 对 ADC 采样 序列 0 的 中 断 
> ADC_INT_DCON_SS1 
> ADC_INT_DCON_SS2 
> ADC_INT_DCON_SS3 
返回 元 
表 B-14 ADCmmtEnable 
功能 使 能 ADC 采样 序列 中 断 
る 7 奋 刑 void ADCIntEnable (uint32_t ui32 Base , 
函数 原型 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
92 ui32SequenceNum 采样 序列 号 
描述 该 函数 使 能 请 求 采样 序列 的 中 断 。 任 何 未 完成 的 中 断 在 使 能 采样 序列 中 断 前 将 被 清除 
返回 无 





表 B-15 ADCIntEnableEx 
功能 使 能 ADC 的 中 断 源 











void ADCIntEnableEx (uint32_t ui32Base, 


























函数 原型 uint32_t ui32IntFlags ) 
参数 ui32Base ADC 模块 基地 址 
ui32IntFlags 禁止 中 断 源 的 位 掩 码 
该 函数 使 能 指定 的 ADC 中 断 源 
ui32IntFlags 参数 以 下 任意 组 合 的 逻辑 或 : 
> ADC_INT_SS0 //ADC 采样 序列 0 中 断 
> ADC_INT_SS1 
> ADC_INT_SS2 
> ADC_INT_SS3 
描述 > ADC_INT DMA SSO  //DMA 对 ADC 采样 序列 0 的 中 断 
> ADC_INT_DMA_SS1 
> ADC_INT_DMA SS2 
> ADC_INT_DMA SS3 
> ADC_INT_DCON_SSO /数字 比较 器 对 ADC 采样 序列 0 的 中 断 
> ADC_INT_DCON_SS1 
> ADC_INT_DCON_SS2 
> ADC_INT_DCON_SS3 
返回 无 
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表 B-16 





ADCIntRegister 



















































































































































































功能 注册 ADC 中 断 的 中 断 处 理 程序 
void ADCIntRegister (uint32_t ui32Base， 
函数 原型 uint32_t ui32SequenceNum , 
void ( * pfnHandler) (void) ) 
ui32Base ADC 模块 基地 址 
参数 ui32SequenceNum 采样 序列 号 
pfnHandler 指向 ADC 中 断 处 理 函 数 的 函数 指针 
该 函数 设置 采样 序列 中 断 发 生 时 被 调用 的 处 理 程序 。 该 函数 使 能 中 断 控制 器 的 全 局 变 中 
描述 断 , 序列 中 断 必須 用 ADCIntEnable( ) 函数 使 能 。 中 断 处 理 程序 使 用 ADCIntClear( ) 函数 负 
去 潜 除 巾 师 》 
责 清 除 中 断 源 
返回 无 
表 B-17 ADCIntStatus 
功能 获得 当前 中 断 状 态 
uint32_t ADCIntStatus (uint32_t ui32Base , 
函数 原型 uint32_t m32SequenceNum , 
bool bMasked ) 
ui32Base ADC 模块 基地 址 
参数 ui32SequenceNum 采样 序列 号 
bMasked 如果 需 要 原始 中 断 状态 ， 则 bMasked 为 false; 如 果 需 要 屏蔽 中 断 状 态 ， 则 
bMasked 为 true 
描述 这 个 函数 返回 指定 的 采样 序列 中 断 状态 。 无 论 是 原始 中 断 状态 ， 还 是 允许 反映 到 处 理 器 
a 的 中 断 状态 均 可 返回 
返回 当前 原始 /屏蔽 中 断 状态 
表 B-18 ADCIntStatusEx 
功能 获得 指定 ADC 模块 的 当前 中 断 状态 
函数 原型 uint32 t ADCIntStatusEx ( uint32_t ui32Base, bool bMasked ) 
参 数 ui32Base ADC 模块 基地 址 
国 bMasked 指定 返回 的 是 屏蔽 中 断 状态 还 是 原始 中 断 状 态 
描述 若 bMasked 设置 为 rue， 则 返回 屏蔽 中 断 状态 ， 否则 返回 原始 中 断 状态 
返回 指定 ADC 模块 的 当前 中 断 状态 。 返 回 值 是 当前 活动 ADC_INT_* 值 的 逻辑 或 
表 了 -19 ADCIntUnregister 
功能 注销 ADC 中 断 的 中 断 处 理 程序 
7 古 刑 void ADCIntUnregister (uint32_t ui32Base， 
函数 原型 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
a ui32SequenceNum 采样 序列 号 
描述 注销 ADC 中 断 处 理 程 序 。 该 函数 禁止 中 断 控 制 器 中 的 全 局 中 断 ; 必须 通过 ADCIntDis- 
He able( ) 来 禁止 序列 中 断 
返回 无 
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表 B-20 ADCPhaseDelayGet 























功能 获取 触发 与 序列 开始 之 间 的 相位 延迟 

函数 原型 uint32_t ADCPhaseDelayGet (uint32_t ui32Base ) 

参数 ui32Base ADC 模块 基地 址 

描述 该 函数 获取 当前 ADC 检测 到 触发 事件 与 序列 开始 之 间 的 相位 延迟 
返回 的 相位 延迟 为 下 列 其 中 一 个 : 











> ADC_PHASE_0 

> ADC_PHASE 22 5 
> ADC_PHASE 45 

> ADC_PHASE 67_5 
> ADC_PHASE_90 

> ADC_PHASE_112_S 
> ADC_PHASE_13S 
> ADC_PHASE_157_S 
> ADC_PHASE_180 
> ADC_PHASE_202_S 
> ADC_PHASE 225 
> ADC_PHASE 247_5 
> ADC_PHASE 270 
> ADC_PHASE_292_S 
> ADC_PHASE_31S 
> ADC_PHASE 337_5 


所 
回 








表 B-21 ADCPhaseDelaySet 
功能 设置 的 触发 与 序列 开始 之 间 的 相位 延迟 





画数 原型 void ADCPhaseDelaySet (unsigned long ulBase , 
ハー ビビ 


unsiened long ulPhase ) 





nm32Base ADC 模块 基地 址 
ui32Phase ”指定 的 相位 延迟 取 值 为 下 列 中 的 一 个 : 
> ADC_PHASE_0 

> ADC_PHASE_22_5 

> ADC_PHASE 45 

> ADC_PHASE 67 5 

> ADC_PHASE_90 

> ADC_PHASE_112_5 

> ADC_PHASE_135 

> ADC_PHASE_157_5 

> ADC_PHASE_180 

> ADC_PHASE_202_5 

> ADC_PHASE_225 

> ADC_PHASE_247_5 

> ADC_PHASE_270 

> ADC_PHASE_292_5 

> ADC_PHASE_315 

> ADC_PHASE_337_5 





该 函数 设置 ADC 检测 到 触发 事件 与 序列 开始 之 间 的 相位 延迟 。 通 过 选择 不 同 的 相位 延 
返 (如 ADC_PHASE 0 与 ADC_PHASE_180) ， 使 每 个 ADC 模块 可 以 对 同一 个 模拟 输入 端 
进行 采样 ， 可 增加 模拟 输入 的 采样 率 。 该 ADC 模块 对 于 该 模块 内 的 所 有 采样 序列 都 具有 
单一 的 相位 延迟 























返回 无 
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表 B-22 ADCProcessorTrigger 
功能 导致 采样 序列 的 处 理 器 触发 








void ADCProcessorTrigger (uint32_t ui32Base, 
uint32_t um32SequenceNum ) 


函数 原型 





ui32Base ADC 模块 基地 址 
参数 ui32SequenceNum ”采样 序列 号 ,为 ADC_TRIGGER_WATT 或 
ADC_TRIGGER_SIGNAL 的 任意 或 运算 














在 采样 序列 的 触发 配置 成 ADC_TRICCER_PROCESSOR 时 ,该 函数 可 用 来 触发 一 个 启 去 
处 理 器 的 采样 序列 。 如 果 序 列 号 由 ADC_TRIGGER_WAIT 的 或 运算 得 到 ， 则 启动 处 理 器 的 



































































































































































































































述 ジコ 本 了 a zy ー 
描述 触发 将 被 延迟 ， 直 到 稍 后 启动 处 理 器 的 触发 指定 为 ADC_TRIGGER_AIGNAL 的 一 个 不 同 
ADC 単元 , 允许 多 个 ADC 以 同步 方式 从 启动 处 理 器 的 触发 开始 采样 
返回 无 
表 B-23 ADCReferenceGet 

功能 返回 当前 设置 的 ADC 基准 
函数 原型 uint32_t ADCReferenceCet (uint32_t um32Base ) 
参 数 ui32Base ADC 模块 基地 址 

返回 设置 的 ADC 基准 电压 值 。 其 返回 值 如 下 : 
描述 > ADC_REE_INT 
Re > ADC_REF_EXT 3V 

> ADC_REF EXT 1V 
返 回 当前 设置 的 ADC 基准 电压 

表 B-24 ADCReferenceSet 
功能 选择 ADC 基准 电压 
に 暫 電 | void ADCReferenceSet (uint32_t ui32 Base , 
函数 原型 uint32_t ui32Ref) 
参数 ui32Base ADC 模块 基地 址 
ui32Ref 使 用 的 基准 
ui32Ref 参数 指定 ADC 的 基准 电压 。 

其 取 值 必须 为 以 下 列 出 的 内 部 或 外 部 基准 电压 之 

> ADC_REE_INT 
描述 > ADC_REF_FEXT 3V 
ぐ ADC_REF_EXT 1V 

> 如 果 选 择 ADC_REF_INT， 则 使 用 内 部 的 基准 3V 电压 ， 无 须 外 部 基准 电压 

> 若 选 择 ADC_REF_EXT_3V， 则 3V 的 基准 电压 必须 连接 到 VDD 引 脚 

> 若 选 择 ADC_REF_EXT_1V， 则 1V 的 外 部 基准 电压 必须 连接 到 VDD 引 脚 
返回 无 

表 B-25 ADCSequenceConfigure 

功能 配置 采样 序列 触发 源 和 优先 级 

void ADCSequenceConfigure ( uint32_t ui32Base， 
本 埋 uint32_t ui32SequenceNum , 
函数 原型 uint32_t ui32Trigger, 

uint32_t ui32Priority ) 
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ui32 Base 


ADC 模块 基地 址 


ui32SequenceNum 采样 序列 号 


ui32 Trigger 启动 采 森 








序列 的 触发 源 ; 必须 是 
ui32Priority ”相对 于 其 他 采样 序列 的 相对 优先 级 


ADC_TRIGGER_* 的 值 之 一 





达 8 个 采样 值 、 
发 条 件 和 优先 级 (相対 
ulTrigger 参数 的 取 值 如 下 : 
> ADC_TRIGGER_PROCESSOR /由 处 理 器 通过 ADCProcessorTrigger ( ) 
L 皿 ComparatorConfigure ( ) 函数 ， 由 第 


此 函数 配置 采样 序列 








> ADC_TRIGGER_COMP0 /7/ 配 





产生 触发 


> ADC_TRIGGER_COMP1 // 配 ComparatorConfigure ( ) 函数 ，E 


生 触 发 


> ADC_TRIGGER_COMP2 // 配 ComparatorConfigure ( ) 函数 ，E 








生 触 发 


> ADC_TRIGCER_EXTERNAL // 由 端 

可以 使用 GPIOADCTrggerEnable ( ) 
> ADC_TRIGCER_TIMER /配置 与 TimerCon trolTrigger ( ) 
> ADC_TRIGGER_PWMO /配置 PWMGenIntTrigEnable ( ) ， 





触发 


> ADC_TRIGGER_PWM1 /配置 PWMGenIntTrigEnable ( ) ， 


触发 


> ADC_TRIGGER_PWM2 /配置 PWMGenIntTrigEnable ( ) ， 


触发 


> ADC_TRIGGER_PWM3 // 配 PWMGenIntTrigEnable () , 由 第 


触发 


> ADC_TRIGGER_ALWAYS -触发 总 是 有 效 ， 造 成 








优先 级 源 有 效 ) 


























于 其 他 采样 序 


i 


























的 初始 标准 。 有 效 的 采 档 
序列 秋生 器 1 和 2 可 捕获 四 个 采样 








序列 范 


值 、 


列 执行 ) 被 设置 





B4 的 引 脚 输入 产 引 








冬 围 为 0 ~3; 
序列 发 9 





3; 序列 发 生 器 0 将 捕获 多 
E 器 3 仅 捕 获 单个 采样 。 触 

















函数 产生 触发 
一 个 模拟 比较 器 

















触发 。 





第 二 个 模拟 比较 器 产 





第 三 个 模拟 比较 器 产 
注意 ， 一 些微 控制 器 





函数 选择 任意 GPIO 








第 一 








， 由 定时 器 产生 触发 
个 PWM 发 生 器 产 里 





计 























重复 捕捉 采样 序列 (只 


第 二 个 PWM 发 生 器 产生 


第 三 个 PWM 发 生 器 产 委 








计 








四 个 PWM 发 生 器 产 4 


LT 





要 没有 更 高 的 





岗 
加 





功能 


无 


表 B-26 


ADCSequenceDataGet 


获取 采样 序列 的 捕获 数据 








函数 原型 


int32 _t 


uint32_t 


ADCSequenceDataGet ( uint32_t m32 Base , 


ui32SequenceNum , 


uint32_t * pui32 Buffer ) 





ui32 Base 


pui32 Buffer 


ADC 模块 基地 址 
ui32SequenceNum 采样 序列 号 
存放 数据 的 地 址 


[=i 





采样 ， 这 


该 函数 把 指定 采样 序列 发 生 器 输出 FIFO 中 的 
I 缓冲 区 中 【〈 假 定 
能 不 是 整个 采样 序列 ， 

















缓冲 区 


数据 








复制 到 内 存 驻 留 缓冲 区 中 。 硬件 mo 


区 足够 容纳 这 些 数 
因此 函数 只 返回 当前 可 用 的 采样 数据 





据 ) 。 如 果 正 在 执行 这 




















返回 复制 : 














到 缓冲 区 中 的 采样 数 


表 B-27 ADCSequenceDisable 


禁止 采样 序列 





void ADCSequenceDisable (uint32_t ui32Base, 


uint32_t un32SequenceNum ) 





ui32 Base 


ADC 模块 基地 址 





ui32SequenceNum 采样 序列 号 





当 检 测 到 触发 时 ， 防 止 指定 的 采 档 








EF 序列 被 捕获 。 配 置 采 档 








fF 序列 前 应 禁止 该 采样 序列 














无 
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表 B-28 ADCSequenceDMADisable 































































































































































































功能 禁止 采样 序列 发 生 器 的 DMA 
函数 原型 void ADCSequenceDMADisable (uint32_t ui32Base, 
原型 uint32_t mi32SequenceNum ) 
参 数 ui32Base ADC 模块 基地 址 
5 ui32SequenceNum 采样 序列 号 
描述 禁止 产生 DMA 请 求 的 指定 序列 发 生 器 采样 
返回 无 
表 B-29 ADCSequenceDMAEnable 
功能 使 能 采样 序列 发 生 器 的 DMA 
函数 原型 void ADCSequenceDMAEnable (uint32_t ui32Base, 
原型 uint32_t ui32SequenceNum ) 
参 数 u32Base ADC 模块 基地 址 
ui32SequenceNum ”采样 序列 号 
描述 根据 采样 序列 发 生 器 的 FIFO 深度 允许 产生 DMA 请 求 
返回 无 
表 B-30 ADCSequenceEnable 
功能 使 能 采样 序列 
語数 原型 void ADCSequenceEnable ( uint32_t ni32 Base , 
函数 原 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
ui32SequenceNum 采样 序列 号 
描述 当 检 测 到 触发 时 ， 人 允许 指定 的 采样 序列 被 捕获 。 在 采样 序列 使 能 前 必须 首先 对 其 进行 
配置 
返回 无 
表 B-31 ADCSequenceOverflow 
功能 确定 采样 序列 是 否 发 生 溢出 
語数 原型 int32 t ADCSequenceOverflow (uint32_t ui32Base, 
函数 原 uint32_t ui32SequenceNum) 
参数 ui32Base ADC 模块 基地 址 
ー ui32SequenceNum ”采样 序列 号 
描述 该 函数 确定 采样 序列 是 否 发 生 溢出 。 如 果 捕 获 到 的 采样 数据 在 下 一 次 触发 前 没有 从 
FIFO 中 读 取 ， 将 会 产生 溢出 
返回 无 溢出 ， 返 回 0; 有 溢出 ， 返 回 非 0 
表 B-32 ADCSequenceOverflowClear 
功能 清除 采样 序列 的 溢出 条 件 
函数 原型 void ADCSequenceOverflowClear (uint32_t ui32Base, 
ぶさ uint32_t ui32SequenceNum ) 
参数 ui32Base ADC 模块 基地 址 
ui32SequenceNum 采样 序列 号 
描述 该 函数 清除 采样 序列 的 一 个 溢出 条 件 。 为 了 检测 后 续 溢 出 条 件 ， 必 须 清 除 溢出 条 件 
返回 无 








表 B-33 ADCSequenceStepConfigure 























































































































功能 配置 采样 序列 发 生 器 的 步 
void ADCSequenceStepConfigure (uint32_t ui32Base, 
到 沥 | 厨 弄 uint32_t ui32SequenceNum , 
函数 原型 uint32_t ui32Step , 
uint32_t ni32Config ) 
ui32Base ADC 模块 基地 址 
ui32SequenceNum ”采样 序列 号 
ui32Step 配置 步 
ui32Config 该 步 的 配置 是 下 列 取 值 的 逻辑 或 : 
> ADC_CTL TS ”// 内 部 温度 传感器 
参数 > ADC_CTL 下 /中断 使 能 
> ADC_CTL_END /采样 结束 
> ADC_CTL_CHx // 采 样 输入 通道 
> ADC_CTL_D // 差 分 选择 
> ADC_CTL TS ”// 内 部 温度 传感器 
> ADC_CTLCMPx ”// 发 送 ADC 采样 值 到 选 定 的 比较 器 
该 函数 用 于 配置 ADC 采样 序列 的 步 。ADC 可 以 配置 成 单 端 或 差分 操作 (将 ADC_CTL_D 
位 置 位 来 选择 差分 操作 ) ; 选择 被 采样 的 通道 (ADC_CTL_CHO ~ ADC_CTL_CH23 的 值 ) ; 
以 及 选择 内 部 温度 传 感 咒 (ADC_CTL_TS 位 ) 
描述 此 外 ， 该 步 可 定义 为 序列 的 末端 ( ADC_CTL_END 位 ) ， 可 将 其 配置 成 在 步 完 成 之 后 ， 
2 发 出 一 个 中 断 (ADC_CTL_IE 位 ) 
当 设备 上 包含 数字 比较 器 时 ， 也 可 使 用 ADC_CTL_CMP0 ~ ADC_CTL_CMP7 来 将 此 步 配 
置 成 发 送 ADC 采样 到 所 选 比 较 器 。 在 该 序列 的 触发 发 生 时 ，ADC 将 会 在 恰当 的 时 间 使 用 
该 配置 
返回 无 
表 B-34 ADCSequenceUnderflow 
功能 确定 采样 序列 是 否 发 生 下 溢出 
下地 int32 t ADCSequenceUnderflow (uint32_t ui32Base , 
函数 原型 uint32_t ui32SequenceNum ) 
参数 ui32Base ADC 模块 基地 址 
ー ui32SequenceNum 采样 序列 号 
描述 该 函数 确定 一 个 采样 序列 是 否 发 生 下 溢出 。 如 果 从 FIFO 中 读 出 的 采样 值 太 多 时 ， 将 会 
Di 发 生 下 泣 
返回 无 下 溢 ， 则 返回 0; 发 生 下 溢出 ,将 返回 非 0 
表 B-35 ADCSequenceUnderflowClear 
功能 清除 采样 序列 的 下 溢出 条 件 
函数 原型 void ADCSequenceUnderflowClear (uint32_t ui32Base, 
1 uint32_t ui32SequenceNum ) 
参数 ui32Base ADC 模块 基地 址 
5 um32SequenceNum ”采样 序列 号 
描述 该 函数 将 清除 采样 序列 中 的 一 个 下 洲 条 件 。 为 了 检测 随后 的 下 溢 条 件 ， 必 须 清 除 该 下 洲 
条 件 
返回 无 
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表 B-36 ADCSoftwareOversampleConfigure 


功能 配置 ADC 软件 的 过 采样 因子 








void ADCSoftwareOversampleConfigure (uint32_t m32 Base , 
函数 原型 uint32_t ni32SequenceNum , 
uint32_t ui32Factor ) 





ui32 Base ADC 模块 基地 址 
参数 ui32SequenceNum 采样 序列 号 
ui32Factor 采样 数据 的 平均 值 













































































该 函数 配置 ADC 的 软件 过 采样 ， 它 可 以 提高 采样 数据 的 分 辨 率 。 软 件 过 采样 对 同一 模 
拟 通道 输入 的 多 个 采样 值 取 平均 以 提高 采样 值 的 精度 。 软 件 过 采样 支持 三 种 (2x、4x、 
描述 8x) 的 过 采样 速率 
过 采样 仅 支 持 深度 超过 一 个 采样 的 采样 序列 发 生 器 ( 即 第 4 个 采样 序列 发 生 器 不 被 支 
持 ， 因 为 其 只 有 一 个 采样 深度 ) 
返回 元 





表 B-37A DCSoftwareOversampleDataGet 





功能 使 用 软件 过 采样 获取 采样 序列 的 捕获 数据 














void ADCSoftwareOversampleDataCet (uint32_t ui32Base, 
uint32_t ui32SequenceNum , 




























































































哨 数 原型 
函数 原型 uint32_t * pui32Buffer, 
uint32_t ui32Count) 

ui32Base ADC 模块 基地 址 
参数 ui32SequenceNum 采样 序列 号 
全 pui32Buffer 存放 数据 的 地 址 

ui32Count 读 取 的 采样 数 

该 函数 应 用 软件 过 采样 将 指定 采样 序列 输出 FIFO 中 的 数据 复制 到 驻 留 内 存 的 缓冲 区 中 。 
描述 所 需 的 采样 值 被 复制 到 数据 缓冲 区 中 ; 如 果 在 硬件 FIFO 中 没有 足够 的 采样 值 以 满足 这 些 

过 采样 数据 项 ， 将 返回 不 正确 的 结果 。 调 用 者 仅 读 取 可 获取 的 采样 值 ， 将 一 直 等 待 到 有 足 
够 的 可 用 数据 

返回 无 

表 B-38 ADCSoftwareOversampleStepConfigure 
功能 配置 软件 过 采样 序列 发 生 器 的 步 

void ADCSoftwareOversampleStepConfigure (uint32_t ui32Base, 
7 下 電 | uint32_t uni32SequenceNum , 
函数 原型 uint32_t ui32Step , 

uint32_t ni32Config ) 

ui32Base ADC 模块 基地 址 

参数 ui32SequenceNum 采样 序列 号 


ui32Step ”配置 步 值 
ui32Config ”此 步 的 配置 











使 用 软件 过 采样 功能 时 ， 该 函数 用 于 配置 采样 序列 发 生 器 的 步 。 可 用 的 步 数 取决 于 
描述 ADCSoftwareOversampleConfigure( ) 函数 配置 的 过 采样 因子 。 其 中 ， 参 数 ui32Config 的 值 与 
ADCSequenceStepConfigure( ) 中 所 定义 的 值 相同 



































返回 无 
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附录 C ”第 5 章 附 录 : GPIO 固件 库 函 数 简 介 


















































































































































NS 
本 章 附 录 将 简要 介绍 GPIO 固件 函数 的 参数 定义 及 功能 说 明 。 
表 C-1 GPIOADCTriggerDisable 
功 和 禁止 GPIO 引 脚 作为 启动 ADC 捕获 的 触发 
i void GPIOADCTriggerDisable (uint32 t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port GPIO 端口 的 基地 址 
3 ui8Pins 引 脚 的 位 填 充 (bit- packed ) 
描述 该 函数 禁止 GPIO 引 脚 作为 启动 ADC 序列 的 触发 。 该 函数 可 用 于 禁止 通过 调用 GPIOAD- 
用 CTriggerEnable ( ) 使 能 的 动作 
返回 参数 无 
表 C-2 GPIOADCTriggerEnable 
功能 使 能 CPIO 引 脚 作为 启动 ADC 捕获 的 触发 
二 void GPIOADCTriggerEnable (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins ) 
参 数 ui32Port GPIO 端口 的 基地 址 
32 ui8Pins 引 脚 的 位 填 充 (bit- packed ) 
该 函数 使 能 GPIO 引 脚 作为 启动 ADC 序列 的 触发 。 任 何 GPIO 引 脚 可 被 配置 成 ADC 序列 
描述 的 一 个 外 部 触发 。 如 果 使 能 所 选 引 脚 上 的 中 断 ，GPIO 引 脚 将 产生 中 断 。 若 要 使 dl 
Me GPIO 引 脚 来 触发 ADC 模块 ， 必 须 用 参数 ADC_TRICCER_EXTERNAL 调用 ADCSequence- 
Configure( ) 函数 
返回 参数 无 
表 C-3 GPIODirModeGet 
功利 获取 引 脚 的 方向 和 模式 
Se | uint32 t GPIODirModeGet (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pin) 
参数 ui32Port ”GPIO 端口 的 基地 址 
5 uni8Pin 引 脚 号 
描述 该 函数 获取 所 选 GPIO 端口 上 指定 引 脚 的 方向 和 控制 模式 。 在 软件 控制 下 该 引 脚 既 可 配 
2 置 为 输入 也 可 配置 为 输出 ， 或 者 引 脚 由 硬件 控制 。 控 制 类 型 和 方向 作为 枚 举 数据 类 型 返回 
返回 参数 为 GPIODirModeSet( ) 返回 一 个 描述 的 枚 举 数 据 类 型 
表 C-4 GPIODirModeSet 
功能 设置 指定 引 脚 的 方向 和 模式 
voidCPIODirModeSet ( uint32_t ui32Port, 
函数 原型 uintS t ui8Pins, 
uint32_t ui32Pin1O ) 
ui32Port GPIO 端口 的 基地 址 
参数 ui8Pins 引 脚 的 位 填充 (bit - packed ) 


ui32PinIO 引 脚 的 方 向 和 / 或 模式 
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( 续 ) 


在 软件 控制 下 ， 该 函数 既 可 把 所 选 CPIO 端口 上 指定 的 引 脚 配置 成 输入 也 可 配置 为 输出 ， 
或 者 将 引 脚 配置 成 由 硬件 控制 

参数 ui32PinIO 是 一 个 枚 举 数据 类 型 ， 其 值 为 下 列 之 一 : 

> GPIO_DIR_MODE_IN ”// 指 定 引 肢 作 为 软件 编程 控制 的 输入 






































































































































描述 > GPIO_DIR_MODE_OUT /指定 引 脚 作为 软件 编程 控制 的 输出 
> GPIO_DIR_MODE_HW /指定 引 脚 由 硬件 控制 
使 用 位 填充 字 节 来 指定 引 脚 ， 其 中 被 置 位 的 每 个 位 ， 标 识 要 访问 的 引 脚 ， 字 节 的 位 0 表 
示 GPIO 端口 引 脚 0， 位 1 表示 CPIO 端口 引 脚 1， 依 此 类 推 
返回 参数 无 
表 C-5 GPIODMATriggerDisable 
功能 禁止 GPIO 引 脚 作为 启动 DMA 交换 的 触发 引 脚 
7 埋 void CPIODMATriggerDisable (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 该 函数 禁止 GPIO 引 脚 作为 启动 DMA 交换 的 触发 引 脚 。 此 函数 可 禁止 通过 调用 GPL 
Ee ODMATriggerEnable( ) 函数 使 能 的 uDMA 交换 
返回 参数 无 
表 C-6 GPIODMATriggerEnable 
功能 使 能 GPIO 引 脚 作为 启动 DMA 交换 的 触发 引 脚 
| void CPIODMATriggerEnable (uint32_ t ui32Port, 
函数 原型 uint8_t ui8Pins ) 
参数 ui32Port CPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 该 函数 使 能 CPIO 引 脚 作为 启动 uDMA 交换 的 触发 引 脚 。 任 何 GPIO 引 脚 都 可 配置 成 外 部 
触发 uDMA。 如 果 已 使 能 了 所 选 引 脚 的 中 断 ， 则 GPIO 引 脚 将 产生 中 断 
返回 参数 无 
表 C-7 GPIOIntClear 
功能 清 除 指定 的 中 断 源 
| void GPIOIntClear (uint32_t ui32Port, 
本 数 原型 uint32_ t ui32IntFlags) 
参数 ui32Port GPIO 端口 的 基地 址 
ui32IntFlags 禁止 中 断 源 的 位 屏蔽 
描述 清 除 指定 中 断 源 的 中 断 
Ee 参数 ui32IntFlags 为 CPIO_INT_* 的 逻辑 或 
返回 参数 无 
表 C-8 GPIOIntDisable 
功能 禁止 指定 的 CPIO 中 断 
吉 凑 | 本 天 void GPIOIntDisable (uint32_t ui32Port, 
函数 原型 uint32_t ui32IntFlags) 
参数 ui32Port ”GPIO 端口 的 基地 址 








ui32 IntFlags 禁止 中 断 源 的 位 屏蔽 





( 续 ) 


该 函数 禁止 指定 的 CPIO 中 断 源 。 只 有 使 能 的 中 断 源 方 能 反映 到 处 理 嚣 中断， 禁止 的 中 
断 源 对 处 理 器 不 会 产生 影响 

ui32 IntFlags 参数 为 以 下 值 的 逻辑 或 : 

> GPIO_INT_PIN 0 ん / 引 脚 0 中 断 

> CPIO_INT_PIN_1 































































































描述 > GPIO_INT_PIN_2 
> GPIO_INT_PIN_3 
> GPIO_INT_PIN_4 
> CPIO_INT_PIN_5 
> CPIO_INT_PIN_6 
> GPIO_INT_PIN 7 ん 引 脚 7 中断 
返 回 参 数 无 
表 C-9 GPIOIntEnable 
功能 使 能 指定 的 CPIO 中 断 
店 埋 voidGPIOIntEnable ( uint32_t ui32Port, 
函数 原型 uint32_t ui32IntFlags ) 
参数 ui32Port CPIO 端口 的 基地 址 
ー u32IntFlags 使 能 中 断 源 的 位 屏蔽 
该 函数 使 能 指定 中 断 源 的 中 断 
ui32 IntFlags 参数 是 以 下 的 逻辑 或 : 
> CPIO_INT_PIN_0/ 引 脚 0 中 断 
> CPIO_INT_PIN 1 
6 > GPIO_INT_PIN 2 
描述 > GPIO_INT_PIN_3 
> CPIO_INT_PIN_4 
> CPIO_INT_PIN_5 
> CPIO_INT_PIN_6 
> CPIO_INT PIN 7 ん 引 脚 7 中断 
返 回 参 数 元 
表 C-10 GPIOmmtRegister 
功能 注册 一 个 GPIO 端口 的 中 断 处 理 程序 
る 本 void CPIOIntRegister (uint32_t ui32Port, 
函数 原型 void ( * pfnIntHandler) (void)) 
参数 ui32Port ”GPIO 端口 的 基地 址 
pinIntHandler 指向 GPIO 端口 中 断 处 理 函 数 的 指针 
当 从 所 选择 的 GPIO 端口 检测 到 一 个 中 断 时 ， 此 函数 可 确保 调用 由 参数 pfnIntHandler 指 
描述 定 的 中 断 处 理 程序 。 这 个 函数 也 可 在 中 断 控制 器 中 使 能 相应 CPIO 的 中 断 ; 单个 引 脚 中 断 
和 中 断 源 必须 由 GPIOIntEnable( ) 函数 使 能 
返回 参数 无 
表 C-11 GPIOIntStatus 
功能 获取 指定 的 CPIO 端口 中 断 状态 
ー uint32 t GPIOIntStatus (uint32_t ui32Port, 
函数 原型 bool bMasked) 
参数 ui32Port ”GPIO 端口 的 基地 址 








bMasked 指定 是 否 返回 屏蔽 或 原始 中 断 状 态 
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( 续 ) 


























































































































描述 如果 bMasked 设置 为 rue， 则 返回 屏蔽 中 断 状态 ， 否 则 ， 返 回 原始 中 断 状 态 
返回 参数 返回 指定 GPIO 的 模块 的 当前 中 断 状态 。 返 回 当前 被 激活 GPIO_INT_ * 值 的 逻辑 或 
表 C-12 GPIOIntTypeGet 

功能 获取 引 脚 的 中 断 类 型 
一 六 i uint32_t GPIOIntTypeGet (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pin) 
会 % ui32Port GPIO 端口 的 基地 址 
参数 ui8Pin 引 脚 号 

该 函数 获取 被 选 GPIO 端口 上 指定 引 脚 上 的 中 断 类 型 。 引 脚 可 被 配置 成 下 降 沿 和 上 升 沿 、 
描述 双边 缘 检测 中 断 、 高 / 低 电 平 检测 中 断 。 中 断 检 测 机 制 的 类 型 可 被 返回 ， 并 且 可 包括 CPIO 

_DISCRETE_INT 标志 
返回 参数 返回 一 个 描述 CPIOmtTypeSet( ) 的 标志 
表 C-13 GPIOIntTypeSet 

功能 设置 指定 引 脚 的 中 断 类 型 

void GPIOIntTypeSet (uint32_t ui32Port, 
函数 原型 uint8_ t ui8Pins, 

uint32_t ui32IntType) 

ui32Port GPIO 端口 的 基地 址 
参数 ui8Pin 引 脚 的 位 填 充 (bit- packed ) 

ui32IntType 指定 类 型 的 中 断 触 发 机 制 

该 函数 为 被 选 CPIO 端口 上 指定 引 脚 设置 各 种 中 断 的 触发 机 制 

ui32IntType 参数 可 用 下 列 之 一 的 标志 定义 : 

> GPIO_FALLING_EDGE // 设 置 下 降 缘 触发 

> GPIO_RISING_EDGE // 设 置 上 升 沿 缘 触 发 

> GPIO_BOTH_EDGES // 设 置 双边 缘 触发 
描述 > GPIO_LOW_LEVEL // 设 置 低 电 平 触发 

> GPIO_HIGH_LEVEL // 设 置 高 电 平 触发 

除了 上 述 标 志 外 ， 也 可 用 下 列 标 志 的 或 运算 表示 ui32IntType 参 数 , 

> CPIO_DISCRETE_INT ”// 设 置 CPIO 端口 每 个 引 脚 上 的 离散 中 断 

这 个 GPIO_DISCRETE_INT 并 非 适用 于 所 有 器 件 或 所 有 GPIO 端口 ， 至 于 哪些 设备 和 

GPIO 端口 支持 离散 中 断 ， 请 查看 数据 手册 
返回 参数 无 
表 C-14 GPIOImtUnregister 

功能 删除 GPIO 端口 的 中 断 处 理 程序 
函数 原型 void GPIOIntUnregister (uint32_t ui32Port ) 
参数 ui32Port GPIO 端口 的 基地 址 
描述 该 函数 注销 指定 GPIO 端口 的 中 断 服 务 程序 。 该 函数 也 禁止 在 中 断 控 制 器 中 相应 CPIO 端 
4 口 的 中 断 ， 对 于 单个 的 CPIO 中 断 和 中 断 源 必 须 通过 CPIOmtDisable( ) 函数 来 禁止 
返回 参数 无 
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表 C-15 GPIOPadConfigGet 


























































































































功能 获取 引 脚 的 焊 盘 (pad) 配置 
void GPIOPadConfigGet (uint32_t ui32Port, 
る 7 直人! uint8_t ui8Pin, 
西数 原型 uint32_t * pui32Strength , 
uint32_ t * pui32PinType) 
ui32Port CPIO 端口 的 基地 址 
参数 u8Pin 引 脚 号 
学 pui32Srength ”指向 输出 驱动 强度 存放 单元 的 指针 
pui32PinType ”指向 输出 驱动 类 型 存放 单元 的 指针 
该 函数 获取 被 选 CPIO 端口 上 指定 引 脚 的 pad ( ) 配置 。 在 pui32Strength 和 pui32PinType 
描述 的 返回 值 应 与 在 GPIOPadConfigSet( ) 中 使 用 的 值 对 应 。 函 数 也 可 将 引 脚 配置 成 输入 引 脚 ，; 
然而 ， 返 回 唯 一 有 意义 的 数据 为 引 脚 终端 是 连接 到 一 个 上 拉 电 阻 还 是 下 拉 电 阻 上 
返回 参数 无 
表 C-16 GPIOPadConfigSet 
功能 设置 指定 的 引 脚 的 焊 盘 (pad) 配置 
void GPIOPadConfigSet (uint32_t ui32Port, 
kt | uint8_t ui8Pins, 
函数 原型 uint32_t ui32Strength, 
uint32_t ui32PinType) 
ui32Port ”GPIO 端口 的 基地 址 
参数 ui8Pins 引 脚 的 位 填充 ( bit - packed ) 
ui32Strength ”指定 输出 驱动 强度 
ui32PinType ”指定 引 脚 类 型 
该 函数 设置 选 定 CPIO 端口 上 指定 引 脚 的 驱动 强度 和 类 型 。 对 于 配置 为 输入 端口 的 引 脚 ， 
Pad 按 要 求 配 置 ， 但 唯一 对 输入 有 真正 影响 是 上 拉 或 下 拉 的 终端 配置 
参数 ui32Strength 为 以 下 值 之 一 : 
> GPIO_STRENGTH 2MA // 指 定 2 mA 输出 驱动 
> CPIO_STRENCTH_4MA 
> GPIO_STRENGTH_8MA 
> CPIO_STRENGTH_8MA_SC / 指 定 8 mA 输出 驱动 带 斜 率 控 制 
> CPIO_STRENGTH_6MA 
描述 > CPIO_STRENGTH_10MA 
0 > CPIO_STRENCTH_12MA 
参 数 ui32PinType 为 以 下 值 之 一 : 
> GPIO_PIN_TYPE_STD // 推 挽 引 脚 
> GPIO_PIN_TYPE_STD_WPU // 弱 上 拉 引 脚 
> GPIO_PIN_TYPE_STD_WPD // 弱 下 拉 引 脚 
> CPIO_PIN_TYPE_OD // 开 漏 引 脚 
> GPIO_PIN_TYPE_ANALOC // 模 拟 输入 
> GPIO_PIN_TYPE_WAKE_HIGH ”// 高 电 平 唤醒 
> CPIO_PIN_TYPE_WAKE_LOW // 低 电 平 唤醒 
返回 参数 无 
表 C-17 GPIOPinConfigure 
功能 配置 GPIO 引 脚 的 复 用 功能 
函数 原型 void GPIOPinConfigure (uint32_t ui32PinConfig) 
参数 ui32PinConfig 引 脚 的 配置 值 ， 指 定 为 唯一 的 GPIO_P?? _??? 值 
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( 续 ) 


该 函数 配置 选 定 GPIO 引 脚 复 用 的 外 设 功 能 ， 每 一 个 GPIO 引 脚 一 次 只 能 配置 成 一 种 外 设 























































































































Wi 功能 
返回 参数 无 
表 C-18 GPIOPinRead 
功能 读 取 指定 引 脚 的 值 
ーー | int32 t GPIOPinRead (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins ) 
参数 ui32Port GPIO 端口 的 基地 址 
< ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 读 取 被 ui8Pins 参数 所 指定 引 脚 的 值 。 返 回 输入 和 输出 引 脚 的 值 ， 没 有 被 ui8Pins 指定 的 
Es 引 脚 被 设置 为 0 
返回 参数 返回 一 个 位 填充 字 节 ， 其 提供 了 指定 引 脚 的 状态 。 没 有 被 ui8Pins 指定 的 任何 位 返回 0。 
并 且 忽略 31:8 位 
表 C-19 GPIOPinTypeADC 
功能 配置 作为 模拟 /数字 转换 器 的 输入 引 脚 
ー void CPIOPinTypeADC (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 模拟 /数字 转换 器 的 输入 引 脚 必须 正确 配置 才能 使 其 功能 正常 。 该 函数 为 这 些 引 脚 提供 
Ma 了 正确 的 配置 
返回 参数 无 
表 C-20 GPIOPinTypeCAN 
功能 配置 作为 CAN 设备 的 引 脚 
ーー | void GPIOPinTypeCAN (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 bit - packed ( 位 填充 ) 
描述 只 有 正确 配置 CAN 引 脚 才能 使 CAN 外 设 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 一 个 典型 
a 的 配置 ， 其 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
表 C-21 GPIOPinTypeCIR 
功能 配置 作为 用 户 红 外 线 输入 或 输出 的 引 脚 
6 | void CPIOPinTypeCIR (uint32_t ui32Ponrt , 
函数 原型 uint8_t ui8 Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 bit 一 packed (位 填充 ) 
描述 只 有 正确 配置 用 户 红外 线 引 脚 才能 使 该 外 设 功能 正常 。 此 函数 为 这 些 引 脚 提 供 了 一 个 正 
es 确 的 配置 
返回 参数 无 
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表 C-22 GPIOPinTypeComparator 






































































































































功能 配置 作为 模拟 比较 器 输入 的 引 脚 
ie | void GPIOPinTypeComparator (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
< ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 模拟 比较 器 输入 的 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提 供 了 正确 
的 配置 
返回 参数 无 
表 C-23 GPIOPinTypeEPI 

功能 配置 用 于 外 设 接口 的 引 脚 
函数 原型 void CPIOPinTypeEPI (uint32_t ui32Port, uint8_t ui8Pins ) 
参数 ui32Port CPIO 端口 的 基地 址 
7 ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 外 设 接口 的 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 一 个 典型 的 
配置 ， 其 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 

表 C-24 GPIOPinTypeEthernetLED 
功能 配置 用 于 作为 以 太 网 外 设 LED 信号 的 引 肢 
7 古 刑 void CPIOPinTypeEthernetLED (uint32 t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port CPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 以 太 网 外 设 提供 两 路 用 于 驱动 一 个 LED 的 信号 (例如 ， 链 路 状态 /活动 )。 此 函数 为 这 
SC 些 引 脚 提供 了 一 个 典型 的 配置 
返回 参数 无 

表 C-25 GPIOPinTypeEthernetMII 
功能 配置 用 于 作为 以 太 网 外 设 MTI 信号 的 引 脚 
ー 1 void GPIOPinTypeEthernetMII (uint32_t ui32Port, 
函数 原 相 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 以 太 网 外 设 上 提供 了 一 组 MII 信号 用 于 连接 到 一 个 外 部 PHY。 此 函数 为 这 些 引 脚 提 供 了 
区 一 个 典型 的 配置 
返回 参数 无 

表 C-26 GPIOPinTypeFan 
功能 配置 用 于 通过 风扇 (fan) 模块 的 引 脚 
本 void GPIOPinTypeFan (uint32_t ui32Port, 

函数 原型 uint8_t ui8Pins ) 
参数 ui32Port GPIO 端口 的 基地 址 





uigPins 引 脚 的 位 填充 d (bit - packe ) 
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( 续 ) 


只 有 正确 配置 风扇 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 一 个 典型 的 配置 ; 



















































































人 其 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
表 C-27 GPIOPinTypeGPIOInput 

功能 配置 作为 CPIO 输入 的 引 脚 
の 1 void GPIOPinTypeGPIOInput (uint32_t ui32Port ， 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 作为 CPIO 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 正确 的 配置 
返回 参数 无 

表 C-28 GPIOPinTypeGPIOOutput 
功能 配置 作为 CPIO 输出 的 引 脚 
| void GPIOPinTypeGPIOOutput (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 GPIO 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 正确 的 配置 
返回 参数 无 

表 C-29 GPIOPinTypeGPIOOutputOD 
功能 配置 作为 GPIO 开 漏 输出 的 引 脚 
a 1 void CPIOPinTypeCPIOOutputOD (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
多 ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 GPIO 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 正确 的 配置 
返回 参数 无 
表 C-30 GPIOPinTypel2C 

功能 配置 作为 DC 外 设 的 引 脚 
吉 半 | 匠 开 | void CPIOPinTypel2C (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 DC 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 正确 的 配置 
返回 参数 无 
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表 C-31 GPIOPinTypel2CSCL 



































































































































功能 配置 作为 2C 外 设 SCL 信号 的 引 脚 
i void GPIOPinTypel2CSCL (uint32_t ui32Port, 
函数 原型 uint8 t ui8Pins ) 
参数 ui32Port CPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 2C 引 脚 才能 使 功能 正常 。 此 函数 为 SCL 引 脚 提供 了 正确 的 配置 
返回 参数 无 
表 C-32 GPIOPinTypeKBColnumn 

功能 配置 作为 扫描 矩阵 键盘 列 输入 的 引 脚 
ーー 9 void GPIOPinTypeKBColumn (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port CPIO 端口 的 基地 址 
3 ui8Pins 引 脚 的 位 填充 (bit - packed ) 
描述 只 有 正确 配置 扫描 矩阵 键盘 输入 引 脚 才能 使 功能 正常 ， 此 函数 为 这 些 引 脚 提供 了 正确 的 

配置 
返回 参数 无 

表 C-33 GPIOPinTypeKBRow 

功能 配置 作为 扫描 矩阵 键盘 行人 的 引 脚 
ーー | void GPIOPinTypeKBRow (uint32_t ui32Port , 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 扫描 矩阵 键盘 输出 引 脚 才能 使 功能 正常 ， 此 函数 为 这 些 引 脚 提 供 了 正确 的 

配置 
返回 参数 无 

表 C-34 GPIOPinTypeLCD 
功能 配置 作为 LCD 控制 器 的 引 脚 
ー void CPIOPinTypeLCD (uint32_t ui32Port , 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 LCD 控制 器 引 脚 才 能 使 功能 正常 ， 此 函数 为 这 些 引 脚 提供 了 一 个 典型 的 
2 配置 ;其 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
表 C-35 GPIOPinTypeLEDSeq 

功能 配置 作为 LED 序列 发 生 器 的 引 脚 
函数 原型 void GPIOPinTypeLEDSeq (uint32_t ui32Port, 





uint8_t ui8Pins) 
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nm32Port GPIO 端口 的 基地 址 























































































































ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 LED 序列 发 生 器 引 脚 才能 使 功能 正常 ， 此 函数 为 这 些 引 脚 提 供 了 正确 的 
配置 
返回 参数 无 
表 C-36 GPIOPinTypeLPC 
功能 配置 作为 LPC 模块 的 引 脚 
ーー | void GPIOPinTypeLPC (uint32 t ui32Port, 
函数 原型 uint8_t ui8Pins ) 
参数 ui32Port GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 LPC 引 脚 才能 是 LPC 模块 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 一 种 典型 
3 的 配置 其 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
表 C-37 GPIOPinTypePECIRx 
功能 配置 用 于 PECI 模块 接收 的 引 脚 
に | 站 天 | void CPIOPinTypePECIRx (uint32 t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port CPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 PECI 接收 引 脚 才能 使 该 功能 正常 。 此 函数 为 该 引 脚 提供 了 一 个 典型 的 
配置 
返回 参数 无 
表 C-38 GPIOPinTypePECITx 
功能 配置 用 于 PECI 模块 发 送 的 引 脚 
-当下 天 | void GPIOPinTypePECITx (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
加 ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 PECI 发 送 引 脚 才 能 使 该 功能 正常 。 此 函数 为 该 引 脚 提供 了 一 个 典型 的 
ee 配置 
返回 参数 无 
表 C-39 GPIOPinTypePWM 
功能 配置 作为 PWM 外 设 的 引 脚 
本 void CPIOPinTypePWM (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins ) 
参数 ui32Port GPIO 端口 的 基地 址 





ui8Pins 引 脚 的 位 填充 (bit- packed ) 





( 续 ) 





























只 有 正确 配置 PWM 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提 供 了 典型 的 配置 。 其 


















































他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
表 C-40 GPIOPinTypeQOEI 

功能 配置 作为 QEI 外 设 的 引 脚 

lb void GPIOPinTypeQEI (uint32_t ui32Port, 

函数 原型 uint8_t ui8Pins) 

参数 ui32Port ”GPIO 端口 的 基地 址 

8 ui8Pins 引 脚 的 位 填充 (bit - packed ) 
描述 只 有 正确 配置 QEI 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 典型 的 配置 。 其 他 
J 配置 可 能 取决 于 板 上 的 设置 

返回 参数 无 

表 C-41 GPIOPinTypeSSI 

功能 配置 作为 SSI 外 设 的 引 脚 

ーー | void CPIOPinTypeSSl (uint32_t ui32Port, 

函数 原型 uint8_t ui8Pins) 

参数 ui32Port GPIO 端口 的 基地 址 

ui8Pins 引 脚 的 位 填充 (bit- packed ) 

描述 只 有 正确 配置 SSI 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提 供 了 典型 的 配置 。 其 他 
配置 可 能 取决 于 板 上 的 设置 

返回 参数 无 





表 C-42 GPIOPinTypeTimer 
功能 配置 作为 定时 器 外 设 的 引 脚 


void GPIOPinTypeTimer (uint32_t ui32Port, 






























































函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit - packed ) 
描述 只 有 正确 配置 CCP 引 脚 才能 使 定时 器 外 设 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 典型 的 配 
置 。 其 他 配置 可 能 取决 于 板 上 的 设置 〈 例 如 ， 使 用 片上 上 拉 ) 
返回 参数 无 
表 C-43 GPIOPinTypeUART 
功能 配置 作为 UART 外 设 的 引 脚 
ーー | void CPIOPinTypeUART (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
= ui8Pins 引 脚 的 位 填充 (bit - packed ) 
描述 只 有 正确 配置 UART 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 典型 的 配置 。 其 
中 他 配置 可 能 取决 于 板 上 的 设置 
返回 参数 无 
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表 C-44 


GPIOPinTYpeUSBAnalog 































































































































































































功能 配置 作为 USB 外 设 的 引 脚 
ー | void GPIOPinTypeUSB Analog (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 某 些 USB 模拟 引 脚 才能 使 该 功能 正常 。 此 函数 为 任何 USB 引 脚 提供 了 正 
确 的 配置 。 这 也 可 以 用 来 配置 EPEN 和 PFAULT 引 脚 ， 使 之 不 再 使 用 USB 控制 器 
返回 参数 无 
表 C-45 GPIOPinTypeUSBDigital 
功能 配置 作为 USB 外 设 的 引 脚 
ー と | void CPIOPinTypeUSBDigital (mnt32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port ”GPIO 端口 的 基地 址 
5 ui8Pins 引 脚 的 位 填 充 (bit- packed ) 
只 有 正确 配置 某 些 USB 数字 引 脚 才能 使 该 功能 正常 。 此 函数 为 数字 USB 引 脚 提供 了 典 
描述 型 的 配置 。 其 他 配置 可 能 取决 于 板 上 的 设置 
函数 应 该 只 用 于 EPEN 和 PFAULT 引 脚 。 因 为 其 他 USB 引 脚本 质 上 都 是 模拟 引 脚 ， 或 
者 其 他 引 脚 在 没有 OTG 功能 时 是 不 能 被 设备 使 用 的 
返回 参数 无 
表 C-46 GPIOPinTypeWakeHigh 
功能 配置 作为 高 电 平 唤醒 休眠 源 的 引 脚 
ー | void GPIOPinTypeWakeHigh (uint32_t m32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port GPIO 端口 的 基地 址 
你 ui8Pins 引 脚 的 位 填充 (bit- packed ) 
描述 只 有 正确 配置 高 电 平 唤 醒 休 眠 源 引 脚 才 能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提供 了 正确 
的 配置 
返回 参数 无 
表 C-47 GPIOPinTypeWakeLow 
功能 配置 作为 低 电 平 唤醒 休眠 源 的 引 脚 
a void GPIOPinTypeWakeLow (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins) 
参数 ui32Port CPIO 端口 的 基地 址 
ーー ui8Pins 引 脚 的 位 填 充 (bit- packed ) 
描述 只 有 正确 配置 低 电 平 唤醒 休眠 源 引 脚 才能 使 该 功能 正常 。 此 函数 为 这 些 引 脚 提 供 了 正确 
本 时 的 配置 
返回 参数 无 
表 C-48 GPIOPinWakeStatus 
功能 获取 唤醒 引 脚 的 状态 
函数 原型 uint32 t GPIOPinWakeStatus (uint32_t ui32Port) 
参 数 ui32Port GPIO 端口 的 基地 址 








( 续 ) 









































ルン 


描述 该 函数 返回 GPIO 唤醒 引 脚 状态 的 值 。 返 回 的 位 字段 通过 0 或 1 显示 引 脚 状态 的 低 或 高 
返回 参数 返回 唤醒 引 脚 的 状态 
表 C-49 GPIOPinWrite 

功能 写 人 一 个 值 到 指定 引 脚 

void CPIOPin Write (uint32_t ui32Port, 
函数 原型 uint8_t ui8Pins, 

uint8_t ui8Val) 

ui32Port ”GPIO 端口 的 基地 址 
参数 ui8Pins 引 脚 的 位 填充 (bit - packed ) 

ui8gVal 写 和 人 到 引 脚 的 值 
描述 写 人 到 由 ui8Pins 指定 的 输出 引 脚 相应 位 的 值 。 而 写 人 到 配置 为 输入 引 脚 的 值 无 影响 
返回 参数 无 








本 章 附录 将 简要 介绍 模拟 比较 器 固件 库 函 数 的 参数 定义 及 功能 说 明 。 


表 D-1 ComparatorConfigure 



































































































































作用 配置 模拟 器 
void ComparatorConfigure (uint32_t ui32Base, 
函数 原型 uint32_t m32Comp , 
uint32_t ni32Config ) 
ui32Base “比较 器 模块 的 基地 址 
参 数 u32Comp ”比较 器 的 索引 
ui32Config ”比较 器 的 配置 
该 函数 配置 模拟 比较 器 。 参 数 ui32Config 是 COMP_TRIG_xxx、COMP_INT_xxx、COMP_ 
ASRCP_xxx 和 COMP_OUTPUT_xxx 值 的 逻辑 或 运算 
① COMP_TRIG_xxx 取 值 如 下 : 
> COMP_TRIG_NONE // 不 触发 ADC 
> COMP_TRIG_HIGH // 当 比较 器 输出 为 高 电 平时 触发 ADC 
> COMP_TRIG_LOW // 当 比较 器 输出 为 低 电 平时 触发 ADC 
> COMP_TRIG_FALL // 当 比较 器 输出 下 降 沿 时 触发 ADC 
描述 > COMP_TRIG_RISE // 当 比较 器 输出 上 升 沿 时 触发 ADC 
> COMP_TRIG_BOTH ”// 当 比较 器 输出 双边 沿 时 触发 ADC 
@ COMP_INT_xxx 取 值 如 下 : 
> COMP_INT_HIGH // 当 比较 器 输出 高 电 平时 产生 中 断 
> COMP_INT_LOW // 当 比较 器 输出 低 电 | 产生 中 断 
> COMP_INT_FALL // 当 比较 器 输出 下 降 沿 时 产生 中 断 
> COMP_INT_RISE // 当 比较 器 输出 上 升 沿 时 产生 中 断 
> COMP_INT_BOTH // 当 比较 器 输出 双边 沿 时 产生 中 断 
③ COMP_ASRCP_xxx 取 值 如 下 : 
> COMP_ASRCP_PIN ”// 使 用 专用 的 Comp + 引 脚 作为 基准 电压 
> COMP_ASRCP_PINO /使 用 专用 的 Comp0 + 引 脚 作为 基准 电压 
描述 > COMP_ASRCP_REF /使 用 内 部 产生 的 电压 作为 基准 电压 
④ COMP_OUTPUT_xxx 取 值 如 下 : 
> COMP_OUTPUT_NORMAL // 使 能 比较 器 非 反 相 输 出 端 ( 同 相 端 ) 
> COMP_OUTPUT_INVERT ”// 使 能 比较 器 的 反 相 输 出 端 
返回 值 无 
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表 D-2 ComparatorIntClear 











































































































作用 清除 比较 器 中 断 
| void ComparatorIntClear (uint32_t ui32Base, 
函数 原型 uint32_t ui32Comp) 
参数 ui32Base ”比较 带 模 块 的 基地 址 
a ui32Comp ”比较 器 的 索引 
描述 清除 比较 器 中 断 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程 序 中 被 调用 ， 以 防止 处 理 器 
退出 时 立即 再 次 被 调用 。 注 意 : 对 于 电 平 触发 的 中 断 ， 在 中 断 无 效 前 不 能 将 它 清除 
返回 值 无 
表 D-3 ComparatorIntDisable 
作用 禁用 比较 器 中 断 
void ComparatorIntDisable (uint32_t ui32 Base , 
函数 原型 uint32_t ui32Comp) 
参数 ui32Base ”比较 器 模块 的 基地 址 
“ ui32Comp ”比较 器 的 索引 
描述 该 函数 禁止 指定 比较 絮 产 生 中 断 
返回 值 无 
表 D-4 ComparatorIntEnable 
作用 使 能 比较 器 中 断 
ーー 1 void ComparatorlIntEnable (uint32_t ni32 Base , 
函数 原型 uint32_t ui32Comp ) 
参数 ui32Base ”比较 器 模块 的 基地 址 
多 ui32Comp ”比较 器 的 索引 
描述 该 函数 使 能 指定 比较 器 产生 中 断 
返回 值 无 
表 D-5 ComparatorIntRegister 
作用 注册 比较 器 中 断 的 中 断 处 理 程序 
void ComparatorIntRegister (uint32_t ui32Base， 
函数 原型 uint32_t ui32Comp ， 
void ( * pfnHandler ) (void) ) 
ui32Base ”比较 器 模块 的 基地 址 
参 数 u32Comp ”比较 器 的 索引 
pfnHandler 指向 当 比 较 器 产生 中 断 时 被 调用 函数 的 指针 
描述 该 函数 在 比较 器 中 断 发 生 时 用 来 设置 被 调用 的 处 理 程序 ， 并 旦 使 能 中 断 控制 器 中 的 中 
BS 断 。 中 断 处 理 程序 通过 调用 ComparatorIntClear( ) 函数 来 负责 清楚 中 断 源 
返回 值 无 
表 D-6 ComparatorIntStatus 
作用 获取 当前 的 中 断 状态 
bool ComparatorIntStatus (uint32_t ui32Base, 
函数 原型 uint32_t mn32Comp , 





bool bMasked ) 
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ui32Base ”比较 器 模块 的 基地 址 
ui32Comp ”比较 器 的 索引 


bMasked 若 需 要 原始 中 断 状态 ， bMasked 为 false; 若 需 要 





屏蔽 中 断 ，bMasked 为 true 





该 函数 返回 比较 器 的 中 断 状 态 。 要 人 么 返 





回 原始 中 断 状态 ;要 么 返回 








屏蔽 中 断 状 态 














如 果 中 断 有 效 ， 则 返回 ue: 否则 返 











回 





alse 


表 D-7 ComparatorIntUnregister 





注销 比较 器 中 断 的 中 断 处 理 程序 








void ComparatorIntUnregister (uint32_t ui32Base, 
uint32_t ui32Comp ) 





ui32Base 比较 器 模块 的 基地 址 
ui32Comp ”比较 器 的 索引 












































在 比较 器 中 断 产生 时 ， 该 函数 用 于 清除 被 调 








中 的 中 断 ， 使 中 断 处 理 程序 就 不 会 被 再 




















次 调用 





的 处 理 程序 。 该 函数 也 会 屏蔽 中 断 控制 器 








无 


表 D-8 ComparatorRefSet 


设置 比较 融 内 部 的 基准 电压 





Void ComparatorRefSet (uint32_t ui32Base , 
uint32_t ui32Ref) 





ui32Base ”比较 右 模 块 的 基地 址 
ui32Ref 基准 电压 值 





总 








该 函数 设置 内 部 的 基准 电压 值 。 电 压 值 可 指定 为 如 下 值 之 一 : 











> COMP_REF_OFF // 关 闭 参考 


[es 

















> COMP_REF OV // 设 置 参考 电压 为 0V 


> COMP_REF_0_1375V 

> COMP_REF_0_275V 

> COMP_REF_0_4125V 

> COMP_REF_0_SSV 

> COMP_REF_0_6875V 

> COMP_REF_0_82SV 

> COMP_REF_0_928125V 
> COMP_REF_0_9625V 

> COMP_REF_ 1 03125Vt 
> COMP_REF_1_134375V 
> COMP_REF_1_1V 

> COMP_REF_1_2375V 

> COMP_REF_1_340625V 
> COMP_REF_1_375V 

> COMP_REF_1_44375V 
> COMP_REF_1_5125V 

> COMP_REF_1_S4687SV 
> COMP_REF_1_65V 

> COMP_REF_1_753125V 
> COMP_REF_1_7875V 

> COMP_REF_1_85625V 
> COMP_REF_1_925V 

> COMP_REF_1_95937SV 
> COMP_REF_2_0625V 

> COMP_REF_2_165625V 
> COMP_REF 2 26875V 








> COMP_REF 2 371875V // 设 置 基准 电压 为 2.371875 V 





高 








无 
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表 D-9 ComparatorValueGet 





作用 获取 当前 比较 器 的 输出 值 
画数 原型 bool ComparatorValueGet ( uint32_t ui32 Base , 
= 


uint32_t ui32Comp ) 





ui32Base ”比较 器 模块 的 基地 址 






































参数 ui32Comp 比较 器 的 索引 
描述 该 函数 获取 当前 比较 器 的 输出 值 
返回 值 若 输 出 值 为 高 电 平 ， 则 返回 为 rue， 若 输出 值 为 低 电 平 ， 则 返回 false 
% 附录 E 第 7 章 附录 : SysTick 与 NVIC 固件 库 函 数 简介 


本 章 附录 将 介绍 SysTick 与 NVIC 的 固件 库 函 数 。 
SysTick 固件 库 函 数 


表 E-1 SysTickDisable 














































































































功能 syd 计数 器 
函数 原型 void SysTickDisable (void) 
描述 该 函数 禁止 系统 定时 器 计数 器 。 若 已 注册 了 一 个 中 断 处 理 程序 ， 那么 在 系统 定时 需 重 局 
前 ， 将 不 会 被 调用 该 中 断 处 理 程序 
返回 参数 元 
表 E-2 SysTickEnable 
功能 。  。 。 | 俩 能 SeTidk 计 数 拓 の ウー ウー ウー ウー 
函数 原型 void SysTickEnable (void) 
描述 该 函数 启动 系统 定时 器 计数 器 。 若 已 注册 了 一 个 中 断 处 理 程序 ， 那么 在 系统 定时 器 计数 
器 翻转 时 ， 将 调用 该 中 断 处理 程 序 
返回 参数 无 
表 EE-3 SysTickIntDisable 
功能 禁止 SysTick 中 断 
函数 原型 void SysTickIntDisable (void) 
描述 该 函数 禁止 系统 定时 器 中 断 ， 防 止 其 被 反射 到 处 理 器 中 
返回 参数 元 
表 E-4 SysTickIntEnable 
函数 原型 void SysTickIntEnable (void ) 
描述 该 函数 使 能 系统 定时 器 中 断 ， 人 允许 其 反射 到 处 理 器 中 
返回 参数 无 








表 E-5 SysTickIntRegister 


























功能 注册 SysTick 中 断 的 中 断 处 理 程序 

函数 原型 Yoid SysTickIntRegister (void ( * pfnHandler) (void) ) 

参 数 pfnHandler 指向 系统 定时 器 中 断 发 生 时 被 调 函数 的 指针 
描述 该 函数 注册 在 系统 定时 器 中 断 发 生 时 被 调用 的 中 断 处 理 程序 
返回 参数 无 


表 EE-6 SysTickIntUnregister 























功能 注销 SysTick 中 断 的 中 断 处 理 程序 

函数 原型 void SysTickIntUnregister (void ) 

描述 该 函数 注销 在 系统 定时 器 中 断 发 生 时 被 调用 的 中 断 处 理 程序 
返回 参数 无 


表 E-7 SysTickPeriodGet 





























功能 获取 SysTick 计数 器 的 周期 

函数 原型 uint32 t SysTickPeriodCet (void ) 

描述 该 函数 返回 SysTick 计数 器 缠绕 (wrap) 计数 的 速度 ， 它 等 于 两 个 中 断 之 间 处 理 器 的 时 
钟 数 

返回 参数 返回 SysTick 计数 器 的 周期 


表 E-8 SysTickPeriodSet 















































功能 设置 SysTick 计数 器 的 周期 
函数 原型 void SysTickPeriodSet (uint32_t m32Period ) 
参 数 u32Period ”每 个 SysTick 计数 器 周期 的 时 钟 滴答 数 (1<SysTick ミ 16, 777 , 216 , ) 
描述 该 函数 设置 SysTick 计数 器 缠绕 (wrap) 计数 的 速度 ， 它 等 于 两 个 中 断 之 间 处 理 器 的 时 
钟 数 
返回 参数 无 
表 E-9 SysTickValueGet 
功能 获取 SysTick 计数 器 的 当前 值 
函数 原型 uint32 +t SysTickValueGet (void ) 
描述 该 函数 返回 SysTick 计数 器 的 当前 值 ( -1< 该 值 <0) 
返回 参数 返回 SysTick 计数 器 的 当前 值 








NVIC 固件 库 函 数 
下 面 将 介绍 NVIC 固件 库 函 数 的 参数 定义 及 功能 说 明 。 


S 


表 E-10 IntDisable 











功能 禁止 中 断 
函数 原型 void IntDisable (uint 32_t ui32Interrupt) 
参数 ui32Interrupt 禁止 指定 的 中 断 
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( 续 ) 




















































































































































































































描述 禁止 中 断 控制 器 中 的 指定 中 断 。 其 他 使 能 的 中 断 不 会 受到 该 函数 的 影响 
返回 参数 无 
表 卫 -11 IntEnable 
功能 使 能 中 断 
函数 原型 void IntEnable ( uint32_t ui32 Interrupt) 
输入 参数 u32Interrupt 禁止 指定 的 中 断 
描述 使 能 中 断 控制 器 中 的 指定 中 断 
返回 参数 无 
表 E-12 IntlsEnabled 
功能 返回 外 设 中 断 是 否 使 能 
函数 原型 uint32 t IntlsEnabled (uint32_t un32Interrupt ) 
输入 参数 ui32Interrupt 指定 检查 中 断 
描述 该 函数 检查 中 断 控制 器 中 指定 的 中 断 是 否 使 能 
返回 参数 若 中 断 使 能 将 返回 一 个 非 零 值 
表 E-13 IntMasterDisable 
功能 禁用 处 理 器 中 断 
函数 原型 bool IntMasterDisable (void ) 
描述 该 函数 防止 处 理 器 收 到 中 断 。 此 函数 不 影响 在 中 断 控 制 器 中 的 中 断 使 能 设置 ， 它 只 管控 
は 从 控制 器 到 处 理 器 的 单一 中 断 
返回 参数 若 函 数 在 调用 时 中 断 已 被 禁止 ， 则 返回 true; 车 中 断 已 被 使 能 ， 则 返回 false 
表 卫 -14 IntMasterEnable 
功能 使 能 处 理 器 的 中 断 
函数 原型 bool IntMasterEnable (void) 
描述 该 函数 允许 处 理 器 响应 中 断 。 此 函数 不 影响 在 中 断 控 制 器 中 的 中 断 使 能 设置 ， 它 只 管控 
Ls 从 控制 器 到 处 理 器 的 单一 中 断 
返回 参数 若 函 数 在 调用 时 中 断 已 被 禁止 ， 则 返回 true; 若 中 断 已 被 使 能 ， 则 返回 false 
表 E-15 IntPendClear 
功能 未 被 挂 起 的 中 断 
函数 原型 void IntPendClear (uint32_t m32Interrupt ) 
输入 参数 ui32Interrupt 指定 的 中 断 未 被 挂 起 
描述 指定 在 中 断 控 制 器 中 未 被 挂 起 的 中 断 。 这 将 导致 任何 先前 产生 的 没有 被 处 理 的 中 断 〈 由 
于 更 高 优先 级 中 断 或 中 断 尚未 被 使 能 将 被 丢弃 
返回 参数 无 
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表 E-16 IntPendSet 



































































































































































































































功能 挂 起 的 中 断 
函数 原型 void IntPendSet (uint32_t ui32 Interrupt) 
输入 参数 ui32Interrupt 指定 挂 起 的 中 断 
描述 指定 中 断 控制 器 中 被 挂 起 的 中 断 。 挂 起 中 断 可 使 中 断 控制 器 根据 当前 的 中 断 状态 的 优先 
级 ， 在 下 一 个 可 用 的 时 间 去 执行 相应 的 中 断 处 理 程序 
返回 参数 无 
表 E-17 IntPriorityGet 
功能 获取 中 断 的 优先 级 
函数 原型 int32_t ntPriorityGet ( uint32_t ui32Interrupt) 
输入 参数 ui32Interrupt 指定 讨论 的 中 断 
描述 该 函数 获取 中 断 的 优先 级 。 参 考 ntPrioritySet () 函数 对 优先 级 值 的 定义 
返回 参数 返回 中 断 的 优先 级 ， 若 指定 一 个 无 效 的 中 断 将 返回 -1 
表 E-18 IntPriorityGroupingGet 
功能 获取 中 断 控制 器 中 的 优先 级 分 组 
函数 原型 uint32_ t IntPriorityCroupingCet (void ) 
描述 该 函数 返回 中 断 优先 级 规范 中 抢占 式 优先 级 与 子 优先 级 等 级 之 间 的 拆 分 
返回 参数 抢占 式 优先 级 的 位 数 
表 E-19 IntPriorityGroupingSet 
功能 设置 中 断 控制 器 的 优先 级 分 组 
函数 原型 void IntPriorityCroupingSet ( umt32_t ui32Bits ) 
输入 参数 ui32Bits ”指定 可 抢占 的 优先 级 的 位 数 
这 个 函数 指定 中 断 优先 级 规范 中 抢占 式 优先 级 与 子 优先 级 等 级 之 间 的 拆 分 。 分 组 值 的 范 
描述 围 依赖 于 硬件 决定 ; 对 于 TIVA C 入 系列 家 族 ， 可 用 3 位 来 决定 硬件 中 断 优先 级 ， 因 此 
优先 级 分 组 值 3 ~7 有 同样 的 效果 
返回 参数 无 
表 E-20 IntPriorityMaskGet 
功能 获取 优先 级 的 屏蔽 等 级 
函数 原型 uint32_ t IntPriorityMaskCet (void) 
这 个 函数 获取 当前 屏蔽 中 断 优先 级 等 级 的 设置 。 返 回 值 是 所 有 中 断 的 优先 级 ， 对 于 优先 
描述 级 较 低 的 中 断 将 被 屏蔽 。 较 小 的 数字 对 应 较 高 的 中 断 优 先 级 ， 值 为 0 时 将 禁止 优先 级 屏 
项 。 而 对 于 硬件 优先 级 机 制 只 需 查看 优先 级 上 面 的 N 位 ( 其 中 N =3 是 TIVA C 和 了 系列 
家 族 ) ， 所 以 任何 优先 级 排序 都 必须 在 这 些 位 中 进行 
返回 参数 返回 中 断 优先 级 屏蔽 的 值 
表 E-21 IntPriorityMaskSet 
功能 设置 优先 级 的 屏蔽 等 级 
函数 原型 void IntPriorityMaskSet (uint32_t ui32Priority Mask ) 
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( 续 ) 
































































































































































































































































































































输入 参数 ui32PriorityMask ” 待 屏蔽 的 优先 级 
描述 此 函数 设置 屏蔽 中 断 优 先 级 ， 因 此 ， 所 有 指定 的 中 断 或 优先 级 较 低 的 中 断 将 被 屏蔽 。 
Mn 掩蔽 中 断 可 用 于 全 局 禁止 优先 级 低 于 预定 阔 值 的 一 组 中 断 ， 值 为 0 时 将 禁止 优先 级 屏 项 
返回 参数 无 
表 E-22 IntPrioritySet 
功能 设置 中 断 的 优先 级 
ー void IntPrioritySet (uint32_t ui32Interrupt, 
函数 原型 uint8_t ui8 Priority ) 
A 3 ui32Interrupt ”指定 讨论 的 中 断 
i 人参 
输入 参数 ui8Priority ”指定 的 中 断 优先 级 
该 函数 用 于 设置 中 断 的 优先 级 。 当 多 个 中 断 同时 有 效 时 ， 具 有 最 高 优先 级 的 中 断 比 那些 
优先 级 低 的 中 断 先行 处 理 。 数 字 越 小 对 应 的 中 断 优先 级 越 高 ， 优 先 级 为 0 的 中 断 优先 级 
, 最高 
9 硬件 优先 级 机 制 只 需 查看 优先 级 上 面 的 N 位 (其 中 N =3 是 TIVA C 和 E 系 列 家族 ) ， 所 
以 任何 优先 级 都 必须 在 这 些 位 中 进行 。 剩 余 的 位 可 用 于 中 断 源 的 子 优先 级 ， 也 可 用 于 将 来 
的 器 件 中 。 这 样 的 安排 允许 优先 级 可 迁移 到 不 同 的 NVIC 中 而 不 改变 总 的 中 断 优 先 级 
返回 参数 无 
表 E-23 IntRegister 
功能 注册 发 生 中 断 时 被 调用 的 函数 
ーー void IntRegister ( uint32_t m321nterrupt , 
函数 原型 void ( * pfnHandler) (void)) 
- i ui32 Interrupt 指定 讨论 的 中 断 
nl 人参 | 的 
输入 参数 pfnHandler 指向 被 调用 函数 的 指针 
当 给 定 处 理 器 中 断 有 效 时 ， 此 函数 用 于 指定 被 调用 的 处 理 函数 。 当 中 断 发 生 时 ， 如 果 
描述 通过 IntEnable( ) 已 使 能 中 断 ， 则 在 中 断 上 下 文中 的 处 理 函 数 将 被 调用 。 因 为 处 理 函 数 可 
a 以 抢占 其 他 代码 ， 因 此 必须 小 心 保护 处 理 程序 和 其 他 非 处 理 程序 代码 所 访问 的 存储 器 或 
外 设 
返回 参数 无 
表 E-24 IntTrigger 
功能 触发 中 断 
函数 原型 void IntTrigger (uint32_t ui32Interrupt) 
输入 参数 ui32Interrupt ”指定 的 触发 中 断 
描述 该 函数 执行 中 断 的 软件 触发 。 若 中 断 控 制 器 中 相应 的 中 断 行 为 有 效 ， 则 以 相同 的 方式 来 
处 理 中 断 
返回 参数 无 
表 E-25 IntUnregister 
功能 注销 发 生 中 断 时 被 调用 的 函数 
函数 原型 void IntUnregister ( uint32_t ni32Interrupt ) 
输入 参数 ui32Interrupt ”指定 的 讨论 中 断 
描述 当 给 定 处 理 器 中 断 有 效 时 ， 此 函数 用 于 指出 无 处 理 函 数 被 调用 。 如 果 必 要 的 话 ， 中 断 源 
的 将 通过 mtDisable( ) 来 自动 清除 
返回 参数 无 
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附录 第 8 章 附 录 : I2C 固件 库 函 数 简介 

































































































































































NN 
本 草 附 录 将 简要 介绍 DC 固件 库 的 参数 定义 及 函数 的 功能 说 明 。 

表 F-1 12CFIEODataGet 
功能 从 DC 接収 FIFO 读 取 一 个 字 节 
函数 原型 uint32 t 12CFIFODataGet (uint32_t ui32Base) 
参数 ui32Base DC 主机 或 从 机 模块 的 基地 址 
描述 函数 从 2C 接收 FIFO 读 取 一 个 字 节 的 数据 ， 以 及 由 参数 pui8Data 在 指定 的 保存 单元 。 
如 果 没 有 可 用 的 数据 该 函数 将 一 直 等 待 到 收 到 数据 才 会 返回 
返回 数据 字 节 

表 F-2 2CFIEODataGetNonBlocking 

功能 从 DC 接収 FIFO 读 取 一 个 字 节 
= uint32 t 12CFIFODataGetNonBlocking (uint32_t ui32Base , 
函数 原型 uint8_t * pui8Data) 
参数 ui32Base 12C 主机 或 从 机 模块 的 基地 址 
IN pui8Data “指向 待 读 取 数据 的 保存 单元 的 指针 
描述 该 函数 从 DC 接收 FIFO IP 字 节 的 数据 ， 以 及 由 参数 pui8Data 在 指定 的 保存 単元 。 
a 如 果 没 有 可 用 的 数据 ， 该 函数 将 返回 0 
返回 从 DC 接收 FIFO 送出 単元 (element) 的 数目 

表 F-3 I2CFIFODataPut 
功能 一 个 数据 字 节 到 PC 发 送 FIFO 
糸数 原型 void I2CFIFODataPut (uint32_t ui32Base , uint8_t ui8 Data ) 
参数 ui32Base DC 主机 或 从 机 模块 的 基地 址 
人 pui8Data 保存 在 发 送 FIFO 中 的 数据 
描述 该 函数 将 据 添 一 加 个 字 节 数据 到 DC 发 送 FIFO 中 。 如 果 在 FIFO 中 没有 可 用 的 空间 ， 
ee 个 函数 将 等 待 到 有 可 用 的 空间 才 会 返回 
返回 无 

表 F-4 I2CFIFODataPutNonBlocking 
功能 为 PC 模块 注册 一 个 中 断 处 理 程序 
uint32_t 12CFIFODataPutNonBlocking (uint32_t ui32Base, uint8_t ui8Data) 
参数 ui32Base 12C 主机 或 从 机 模块 的 基地 址 
pui8 Data 保存 在 发 送 FIFO 中 的 数据 
描述 该 函数 将 据 添 一 加 个 字 节 数据 到 I2C 发 送 FIFO 中 。 如 果 在 FIFO 中 没有 可 用 的 空间 ， 
A 函数 将 返回 0 
返回 无 
表 F-5 I2CFIFOStatus 

功能 获取 当前 的 FIFO 状态 
函数 原型 uint32 t I2CFIFOStatus ( uint32_t ui32 Base ) 
参数 ui32Base 12C 主机 或 从 机 模块 的 基地 址 
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( 续 ) 





此 函数 获取 发 送 (TX) 和 接收 (RX) FIFO 的 状态 。 可 使 用 DCTxFIFOConfigSet( ) 函数 









































































































































































































































描述 来 设置 发 送 FIFO 的 触发 深度 与 使 用 DCTxFIFOConfigSet( ) 函数 来 设置 接收 F IFO 的 触发 
深度 
返回 FIFO 的 状态 ， 枚 举 为 包含 下 列 值 的 位 字段 : 
> I2C_FIFO_RX_BEL >» 0W_TRIG_LEVEL 
> DPC_FIFO_RX_FUIL 
返回 > LC_FIFO_RX_EMPTY 
> 12C_FIFO_TX_BELOW_TRIC_LEVEL 
> DPC_FIFO_TX_FULL 
> 12C_FIEO_TX_EMPTY 
表 F-6 I2CintRegister 
功能 注册 DC 模块 的 中 断 处 理 程序 
函数 原型 void 2CIntRegister (uint32_t ui32Base, void ( * pinHandler) (void) ) 
参数 ui32Base DC 主机 模块 的 基地 址 
1 pinHandler 指向 当 2C 中 断 发 生 时 待 调用 函数 的 指针 
当 [2C 中 断 发 现时 该 函数 设置 待 调用 的 处 理 程序 。 这 个 函数 使 能 中 断 控制 器 中 的 全 局 中 断 ; 
描述 具体 的 PC 中 断 必须 通过 2CMasterIntEnable( ) 和 I2CSlaveIntEnable( ) 函数 使 能 。 若 有 必要 ， 中 断 
处 理 程 序 可 通过 12CMasterIntClear( ) 和 I2CSlaveIntClear( ) 函数 来 负责 清除 中 断 源 
返回 无 
表 F-7 2CintUnregister 
功能 注销 DC 模块 的 中 断 处 理 程序 
函数 原型 void 12CIntUnregister (uint32_t ui32Base ) 
参 数 u32Base DC 主机 模块 的 基地 址 
描述 当 2C 发 生 中 断 时 该 函数 清除 待 调 用 的 处 理 程 序 。 这 个 函数 也 可 屏蔽 掉 中 断 控制 器 中 的 
a 中 断 ， 以 使 中 断 处 理 程序 不 再 被 调用 
返回 无 
表 F-8 I2CMasterBurstCountGet 
功能 返回 突 发 传送 计数 器 的 的 当前 值 
函数 原型 uint32_t 12CMasterBurstCountGet ( uint32_t ui32Base ) 
参 数 nm32Base DC 主机 模块 的 基地 址 
描述 该 函数 返回 用 于 FIFO 机 制 突 发 传送 计数 器 的 当前 值 。 软 件 可 以 使 用 该 值 来 确定 在 传输 
中 保持 多 少 个 字 节 ,或 者 ， 若 发 生 了 错误 时 ， 在 哪里 进行 突 发 传输 操作 
返回 无 
表 F-9 I2CMasterBurstLengthSet 
功能 指示 DC 总 线 是 否 忙碌 
函数 原型 void 12CMasterBurstLengthSet (uint32_t ui32Base, uint8_t ui8 Length ) 
参数 ui32Base DC 主机 模块 的 基地 址 
9 ui8Length ” 突 发 传输 的 长 度 
该 函数 配置 2C 主机 FIFO 操作 的 突 发 传输 长 度 。 突 发 字段 被 限定 于 8 位 或 256 字 节 之 
描述 内 。 突 发 长 度 适 用 于 单一 的 PCMCS BURST 操作 ， 这 意味 着 指定 的 突 发 长 度 仅 为 当前 操作 
(可 以 发 送 或 接收 ) 。 每 次 进行 突 发 操作 时 ， 必 须 使 用 2CMaslerConuol( ) 写 PCMCS 中 的 
BURST 位 来 配置 突 发 长 度 的 优先 级 
返回 无 
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表 F-10 1 
指示 DC 总 线 是 否 忙碌 


CMasterBusBusy 





bool LDCMasterBusBusy ( 


uint32_t ui32Base) 





ui32Base DC 主机 模块 的 基地 址 





该 函数 返回 DC 总 线 是 否 











有 男 一 主机 正在 使 用 总 线 





否 忙 碌 的 指示 。 这 个 函数 可 以 用 于 多 主机 环境 中 以 确定 当前 是 否 








功能 





用 





若 DC 总 线 处 于 忙碌 状态 ， 





表 F-11 
指示 DC 主机 是 否 忙碌 








则 返回 ture; 和 否则， 返回 false 


12CMasterBusy 





函 


数 原型 


tBoolean I2CMasterBusy (unsigned long ulBase ) 





数 


ui32Base DC 主机 模块 自 


9 基地 址 





炎 函 数 返 回 2C 主机 是 否 





正 忙 于 发 送 或 接收 数据 的 指示 








回 








若 2C 总 线 处 于 忙碌 状态 











， 则 返回 ture; 和 否则， 返回 false 


表 F-12 12CMasterControl 
控制 DC 主机 模块 的 状态 








void 12CMasterControl (uint32_t ui32Base , uint32_t ui32Cmd ) 





nm32Basel2C 主机 模块 的 基地 址 
ui32Cmd 下 达 给 12C 主机 模块 的 命令 





总 





该 函数 用 于 控制 主机 模块 发 送 和 接收 操作 的 状态 
参数 ui32Cmd 为 下 列 值 之 一 : 

> 12C_MASTER_CMD_SINGLE_SEND 

> DPC_MASTER_CMD_SINGLE_RECEIVE 














> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> I2C_MASTER_CMD_BU 
> DPC_MASTER_CMD_BU 
> DPC_MASTER_CMD_QU 





> DPC_MASTER_CMD_HS_ 


RST_SEND_START 
RST_SEND_CONT 
RST_SEND_FINISH 
RST_SEND_ERROR_STOP 
RST_RECEIVE_START 
RST_RECEIVE_CONT 
RST_RECEIVE_FINISH 
RST_RECEIVE_ERROR_STOP 
ICK_COMMAND 
MASTER_CODE_SEND 


> 12C_MASTER_CMD_FIFO_SINGLE_SEND 





总 


> DC_MASTER_CMD_FIFO_SINGLE_RECEIVE 

> DPC_MASTER_CMD_FIFO_BURST_SEND_START 

> DC_MASTER_CMD_FIFO_BURST_SEND_CONT 

> DC_MASTER_CMD_FIFO_BURST_SEND_FINISH 

> DPC_MASTER_CMD_FIFO_BURST_SEND_ERROR_STOP 

> DPC_MASTER_CMD_FIFO_BURST_RECEIVE_START 

> DPC_MASTER_CMD_FIFO_BURST_RECEIVE_CONT 

> 12C_MASTER_CMD_FIFO_BURST_RECEIVE_FINISH 

> DPC_MASTER_CMD_FIFO_BURST_RECEIVE_ERROR_STOP 














高 


功 





台 E 
用 





无 


表 F-13 1I2CMasterDataGet 


接收 一 个 发 送 给 PC 主机 


的 字 节 





函 


数 原型 


uint32 t 12CMasterDataGet (uint32_t ui32 Base ) 





全 


数 





u32Base DC 主机 模块 的 基地 址 
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函数 读 取 ZC 主机 数据 寄存 器 中 一 个 字 节 的 数据 




















































































































该 函 
返回 返回 从 2C 主机 接收 的 字 节 并 强制 转换 为 uint32_t 类 型 
表 F-14 I2CMasterDataPut 
功能 从 DC 主机 发 送 一 个 字 节 
函数 原型 i (uint32_t ui32Base , 
参数 ui32Base DC 主机 模块 的 基地 址 
ui8Data 从 IC 主机 被 发 送 的 数据 
描述 该 函数 把 提供 的 数据 保存 到 12C 主机 数据 寄存 器 中 
返回 无 
表 F-15 I2CMasterDisable 
功能 禁止 2C 主机 模块 
函数 原型 void DPCMasterDisable (uint32_t ui32Base) 
参数 ui32Base 12C 主机 模块 的 基地 址 
描述 该 函数 禁止 2C 主机 块 的 操作 
返回 无 
表 F-16 2CMasterEnable 
功能 使 能 PC 主机 模块 
函数 原型 void 2CMasterEnable (uint32_t ni32Base ) 
参 数 ui32Base 12C 主机 模块 的 基地 址 
描述 该 函数 使 能 2C 主机 块 操作 
返回 无 
表 F-17 I2CMasterErr 
功能 获取 DC 主机 模块 的 错误 状态 
函数 原型 uint32_t DPCMasterErr (uint32_t ui32Base) 
参数 ui32Base PC 主机 模块 的 基地 址 
描述 该 函数 用 于 获取 主机 模块 发 送 和 接收 操作 的 错误 状态 
返回 如 下 之 一 的 错误 状态 : 
> 12C_MASTER_ERR_NONE 
返回 > I2C_MASTER_ERR_ADDR_ACK 
> DPC_MASTER_ERR_DATA_ACK 
> 12C_MASTER_ERR_ARB_LOST 
表 F-18 I2CMasterGlitchFilterConfigSet 
功能 配置 2C 主机 故障 过 滤器 
画数 原型 ne eS (uint32_t ui32 Base , 
参数 ui32Base 12C 主机 模块 的 基地 址 





u32Config 故障 过 滤器 配置 





( 续 ) 


该 函数 配置 2C 主机 故障 过 滤器 。 通 过 对 ui32config 价值 决定 故障 滤波 器 的 采样 范围 ， 
值 传递 给 ui32Config 以 确定 故障 滤波 器 的 采样 范围 ， 它 可 配置 为 1 ~32 个 系统 clock cycles. 
时 钟 周期 。 故 障 滤波 器 的 默认 配置 为 0 个 系统 时 钟 周期 ， 即 故障 滤波 器 被 禁止 

ui32config 字段 应 为 下 列 的 任意 值 : 

> 12C_MASTER_GLITCH_FILTER_DISABLED 

> LDC_MASTER_GLITCH_FILTER_1 
































































































































































































































描述 > DPC_MASTER_CLITCH_FILTER_2 
> DPC_MASTER_CLITCH_FILTER_3 
> DC_MASTER_GLITCH_FILTER_4 
> DPC_MASTER_CLITCH_FILTER_8 
> 2C_MASTER_GLITCH_FILTER_16 
> LDC_MASTER_GLITCH_FILTER_32 
返回 无 
表 F-19 I2CMasterInitExpClk 
功能 初始 化 DC 主机 模块 
函数 原型 void 12CMasterInitExpClk (uint32_t ui32Base, uint32_t ui32I2CCIk ，bool bFast) 
ui32Base 12C 主机 模块 的 基地 址 
参数 ui322CCIk ”提供 给 2C 模块 的 时 钟 速率 
bFast 设置 快速 数据 传输 
该 函数 通过 设置 主机 的 总 线 速度 和 使 能 PC 主机 模块 来 初始 化 DC 主机 模块 的 操作 
如 果 参 数 bFast 为 true， 则 主机 模块 以 400Kbps 传输 数据 ， 否则 将 以 100Kbps 传输 数据 。 
若 需 要 快速 + 模式 (1 Mbps)， 软 件 应 在 调用 这 个 函数 前 手工 编写 DCMTPR。 对 于 高 速 
描述 (3.4Mbps) 模式 ， 在 以 100Kbps 或 400Kbps 的 速率 与 从 机 进行 最 初 的 通信 之 后 ， 需 个 
特定 的 命令 来 将 其 切换 到 更 快 的 时 钟 速率 
外 设 时 钟 与 处 理 器 时 钟 相同 。 该 值 由 SysCtlClockGet( ) 返回 ， 或 者 ， 在 该 时 钟 为 一 个 已 
知 值 或 常量 时 ， 可 表示 成 显 式 地 硬 编码 
返回 无 
表 F-20 12CMasterIntClear 
功能 清除 2C 主机 的 中 断 源 
函数 原型 void 12CMasterIntClear (uint32_t ui32Base) 
参 数 u32Base DC 主机 模块 的 基地 址 
描述 清除 PC 主机 的 中 断 源 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 中 被 调用 ， 防 止 在 
RE 退出 时 中 断 立即 被 再 次 触发 
返回 无 
表 F-21 12CMasterIntClearEx 
功能 清除 2C 主机 的 中 断 源 
函数 原型 void 12CMasterIntClearEx (uint32_t ui32Base, uint32_t ui32IntFlags) 
参数 ui32Base DC 主机 模块 的 基地 址 
u32IntFlags ” 待 清除 中 断 源 的 屏蔽 位 
描述 指定 PC 主机 要 清除 的 中 断 源 ， 使 之 不 再 有 效 。 这 个 函数 必须 在 中 断 处 理 程 序 中 被 调 
"て ， 以 防止 在 退出 时 中 断 立 即 被 再 次 触发 
返回 无 
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表 F-22 12CMasterIntDisable 

















功能 禁止 DC 主 机 中 断 

函数 原型 void 12CMasterIntDisable (uint32_t ui32Base) 
参 数 u32Base 12C 主机 模块 的 基地 址 

描述 该 函数 清除 I2C 主机 的 中 断 源 

返回 无 








表 F-23 12CMasterIntDisableEx 

































































功能 清除 单个 DC 主机 的 中 断 源 
函数 原型 void J2CMasterIntDisableEx (uint32_t ui32Base, uint32_t ui32IntFlags) 
TB2Paws DC 主机 模 所 的 基地 址 
u32IntFlags ” 待 清除 中 断 源 的 屏蔽 位 

描述 这 个 函数 关闭 指定 的 PC 主 机 中 断 源 。 只 有 使 能 这 个 中 断 源 才 可 以 反映 到 处 理 器 中 断 ; 

关闭 中 断 源 不 会 对 处 理 器 造成 影响 
返回 无 

表 F-24 I2CMasterIntEnable 

功能 使 能 PC 主机 中 断 
函数 原型 void 12CMasterIntEnable (uint32_t ui32 Base ) 
参 数 ui32Base DPC 主机 模块 的 基地 址 
描述 该 函数 使 能 2C 主机 的 中 断 源 
返回 无 








表 F-25 12CmasterIntEnableEx 


功能 使 能 单个 DC 主机 的 中 断 源 

















void 12CMasterIntEnableEx (uint32_t ui32Base, 





数 原型 
函数 原 uint32_t ui32IntFlags ) 
参数 ui32Base 12C 主机 模块 的 基地 址 





u32IntFlags ” 待 使 能 中 断 源 的 屏蔽 位 




















该 函数 使 能 指定 2C 主机 的 中 断 源 。 只 有 使 能 这 个 中 断 源 才 可 以 反映 到 处 理 器 中 断 ; 关 
闭 中 断 源 不 会 对 处 理 器 造成 影响 
参数 uilntFlags 是 以 下 任意 值 的 逻辑 或 
> 2C_MASTER_INT_RX_FIFO_FULL//RX FIFO 满 中 断 
> DPC_MASTER_INT_TX_FIFO_EMPTY //TX FIFO 空中 断 
> 2C_MASTER_INT_RX FIFO_REO0// RX FIFO 请 求 中 断 
> 2C_MASTER_INT_TX_FIFO_REQO// TX FIFO 请 求 中 断 
描述 > RC_MASTER_INT_ARB_LOST// 仲 裁 丢失 中 断 
> DPC_MASTER_INT_STOP // 停 止 条 件 中 断 
> 12C_MASTER_INT_START /开始 条 件 中 断 
> 12C_MASTER_INT_NACK /地 址 /数据 不 应 答 (NACK) 中 断 
> 12C_MASTER_INT_TX_DMA_DONE//TX DMA 完成 中 断 
> 2C_MASTER_INT_RX_DMA_DONE//RX DMA 完成 中 断 
> 12C_MASTER_INT_TIMEOUT // 时 钟 超时 中 断 
> DPC_MASTER_INT_DATA // 数 据 中 断 


























所 
加 





无 
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表 F-26 12CMasterIntStatus 













































































































































































功能 获取 当前 LC 主机 的 中 断 状态 
函数 原型 bool 12CMasterIntStatus (uint32_t ui32 Base , bool bMasked ) 
ui32Base DC 主机 模块 的 基地 址 
参数 bMasked ” 若 要 求 原始 中 断 状态 ， 则 bMasked 为 false; 若 需 要 屏蔽 中 断 状 态 ， 则 bMasked 
为 true 
该 函数 返回 DC 主机 模块 的 中 断 状态 。 可 返回 原始 中 断 状态 或 允许 反映 到 处 理 器 中 的 中 
he 断 状态 
返回 返回 当前 的 中 断 状 态 ， 激 活 返回 rue， 未 激活 则 返回 false 
表 F-27 2CMasterIntStatusEx 
功能 获取 当前 DC 主机 的 中 断 状态 
函数 原型 uint32_t 12CMasterIntStatusPx (uint32_t ui32Base , bool bMasked ) 
u32Base DC 主机 模块 的 基地 址 
参数 bMasked 若 要 求 原 始 中 断 状态 ， 则 bMasked 为 false; 若 需 要 屏蔽 中 断 状 态 ， 则 pMasked 
为 true 
描述 该 函数 返回 DC 主机 模块 的 中 断 状 态 。 可 返回 原始 中 断 状态 或 允许 反映 到 处 理 器 中 的 中 
返回 返回 当前 中 断 状态 ， 在 DCMasterIntEnableEx( ) 中 枚 举 为 位 字段 的 值 
表 F-28 12CMasterLineStateGet 
功能 读 取 SDA 和 SCL 引 脚 的 状态 
函数 原型 uint32_t PCMasterLineStateCet ( uint32_t ui32Base) 
参 数 un32Base DC 主机 模块 的 基地 址 
描述 该 函数 通过 提供 的 SDA 和 SCL 引 脚 的 实时 值 返回 2C 总 线 的 状态 
返回 返回 总 线 的 状态 ， 使 SDA 在 位 位 置 1 以 及 SCL 在 位 位 置 0 (with SDA in bit position 1 and 
I SCL in bit position 0 ) 
表 F-29 I2CMasterSlaveAddrSet 
功能 设置 PC 主机 在 总 线 上 的 地 址 
函数 原型 void 12CMasterSlaveAddrSet (uint32_t ui32Base，uint8_t ui8SlaveAddr, bool bReceive ) 
ui32Base DC 主机 模块 的 基地 址 
参 数 un8SlaveAddr 7 位 从 机 地 址 
bReceive ”指示 与 从 机 通信 的 类 型 标志 
描述 当 启 动 通信 和 时， 该 函数 设置 放置 到 总 线 上 的 DC 主机 地 址 。 当 参数 bReceive 设置 成 true 
1 时 ， 地 址 将 指示 I2C 主机 正 启动 从 机 读 ; 否则 指示 2C 主机 正 启动 从 机 写 
返回 无 
表 F-30 I2CMasterTimeoutSet 
功能 设置 主 时 钟 的 超时 值 
函数 原型 void 12CMasterTimeoutSet ( uint32_t ui32Base, uint32_t ui32 Value ) 
参数 ui32Base DC 主机 模块 的 基地 址 
ui32 Value 超时 的 PC 时 钟 数 
描述 该 函数 使 能 与 配置 在 PC 外 备 的 时 钟 低 超时 特性 。 此 特性 以 12 位 的 计数 器 执行 ， 其 高 8 
a 位 是 可 编程 的 
返回 无 
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表 F-31 12CRxFIEOConfigSet 








功能 配置 PC 的 接収 (RX) FIFO 
函数 原型 void 12CRxFTFOConfigSet (uint32_t ui32Base, uint32_t m32Config ) 
参 数 ui32Base DC 主机 或 从 机 模块 的 基地 址 


ui32Config 使 用 指定 宏 的 配置 FIFO 











配置 DC 外 设 的 接收 FIFO。 主 机 或 从 机 都 可 以 使 用 接收 FIFO ， 但 它们 不 能 同时 被 使 用 。 
以 下 宏 用 来 配置 带 或 不 带 DMA 的 主机 或 从 机 的 RX FIFO 行为 : 

> DC_FIFO_CFG_RX_MASTER 

> DC_FIFO_CFG_RX_SLAVE 

> DC_FIFO_CFG_RX_MASTER_DMA 

> DC_FIFO_CFG_RX_SLAVE_DMA 

使 用 下 面 其 中 一 个 宏 来 选择 FIFO 的 触发 深度 : 
描述 > LC_FIFO_CFG_RX_TRIG 1 

> DC_FIFO_CFG_RX_TRIG 2 

> 2C_FIFO_CFC_RX_TRIC_3 

> DC_FIFO_CFG_RX_TRIG 4 

> DC_FIFO_CFG_RX_TRIG 5 

> LC_FIFO_CFG_RX_TRIG 6 

> DC_FIFO_CFG_RX_TRIG 7 

> DC_FIFO_CFG_RX_TRIG 8 















































































































































返回 无 
表 F-32 了 CRxFIFOFlush 
功能 刷新 2C 的 接收 (RX) FIFO 
函数 原型 void 了 CRxFIFOFlush (uint32_t mi32Base ) 
参 数 ui32Base DPC 主机 或 从 机 模块 的 基地 址 
描述 该 函数 刷新 2C 的 接收 (RX) FIFO 
返回 无 
表 F-33 2CSlaveACKOYverride 
功能 配置 2C 从 机 的 应 答 (ACK) 重 载 行为 
函数 原型 void 2CSlaveACKOverride (uint32_t ui32Base , bool bEnable ) 
参数 ui32 Base DC 从 机 模块 的 基地 址 
bEnable 使 能 或 禁止 ACK 重 载 
描述 该 函数 使 能 或 禁止 ACK 重 载 ， 允 许 用 户 程序 在 ACK 期 间 驱 动 SDA 上 的 值 
返回 无 
表 F-34 2CSlaveACKValueSet 
功能 写 应 答 (ACK) 的 値 
函数 原型 void 2CSlaveACKValueSet (uint32_t ui32Base, bool bACK ) 
参数 ui32Base 12C 从 机 模块 的 基地 址 
bACK 选择 传输 中 是 应 答 (ae) 还 是 不 应 答 (faluse) 
描述 该 函数 在 ACK 周期 把 所 需 ACK 值 放 置 在 SDA 上 。 号 入 的 値 具有 当 使用 
12CSlaveACKOveride ( ) 使 能 重 载 ACK 时 才 有 效 
返回 无 
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表 F-35 12CSlaveAddressSet 

















功能 设置 PC 的 从 机 地 址 

函数 原型 void 12CSlaveAddressSet (uint32_t ui32Base, uint8_t ui8 AddrNum, uint8_t ui8SlaveAddr) 
ui32Base 12C 从 机 模块 的 基地 址 

参数 ui8AddrNum ”确定 设置 哪个 从 机 地 址 
ui8SlaveAddr 7 位 从 机 地 址 

描述 该 函数 写 数 据 到 指定 的 从 机 地 址 。ulAddrNum 字段 指定 将 配置 哪个 从 机 地 址 

返回 无 


表 F-36 12CSlaveDataGet 

















功能 接收 一 个 发 送 给 PC 从 机 的 字 节 

函数 原型 uint32 t 12CSlaveDataGet (uint32_t ui32Base) 

参 数 u32Base DPC 从 机 模块 的 基地 址 

描述 该 函数 从 DC 从 机 数据 寄存 器 中 读 取 一 个 字 节 的 数据 
返回 返回 2C 从 机 收 到 的 字 节 并 强制 转换 成 uint32_t 类 型 











表 F-37 I2CSlaveDataPut 
功能 12C 从 机 发 送 一 个 字 节 的 数据 








函数 原型 void 12CSlaveDataPut (uint32_t ui32Base , uint8_t ui8Data ) 





ui32Base I2C 从 机 模块 的 基地 址 

























































































参 妆 ee 
参数 ui8Data DC 从 机 待 发 送 的 数据 
描述 该 函数 将 提供 的 数据 放置 到 I2C 从 机 的 数据 寄存 器 中 
返回 无 

表 F-38 I2CSlaveDisable 
功能 禁止 DC 从 机 模块 
函数 原型 voidI2CSlaveDisable (uint32_t m32 Base ) 
参数 ui32Base DC 从 机 模块 的 基地 址 
描述 该 函数 禁止 2C 从 机 模块 的 操作 
返回 无 

表 F-39 I2CSlaveEnable 
功能 使 能 PC 从 机 模块 
函数 原型 void DCSlaveEnable (uint32_ t ui32Base) 
参数 ui32Base 1I2C 从 机 模块 的 基地 址 
描述 该 函数 使 能 2C 从 机 模块 的 操作 
返回 无 

表 F-40 I2CSlaveFIFODisable 

功能 禁用 DC 从 机 模块 使 用 FIFO 
函数 原型 void 12CSlaveFTFODisable (uint32_t ui32Base ) 
参 数 ui32Base DC 从 机 模块 的 基地 址 
描述 该 函数 禁止 2C 从 机 模块 使 用 FIFO。 调 用 该 函数 后 ， 虽 然 FIFO 被 禁止 , 但 从 机 模块 仍 
0 然 保持 有 效 
返回 无 
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表 F-41 I2CSlaveFIFOEnable 




































































































































































































































































功能 使 能 PC 从 机 模块 的 FIFO 使 
ーー | void 12CSlaveFTFOEnable (uint32_t ui32Base, 
函数 原型 uint32_t ui32Config) 
参数 ui32Base DC 从 机 模块 的 基地 址 
ui32Config 所 需 的 12C 从 机 模块 配置 
该 函数 配置 PC 从 机 模块 的 FIFO 使 用 。 该 函数 应 与 CTxFIFOConfigSet ( ) 和 /或 
I2CRxFIFOConfigSet( ) 组 合 使 用 ， 可 配置 FIFO 的 触发 深度 ， 并 告诉 FIFO 硬件 是 否 与 DC 
主机 或 从 机 交互 。ui32Config 字段 为 DC_SLAVE_TX_FIFO_ENABLE 与 DC_SLAVE_RX_ 
描述 FIFO_ENABIE 的 恰当 组 合 
从 机 PCSCSR 寄存 器 为 只 写 , 那么 在 调用 I2CSlaveEnable ( ) 、2CSlaveDisable 或 
I2CSlaveFIFOEnable( ) 时 需 重 写 从 机 配置 。 因 此 ， 应 用 软件 应 先行 调用 ZCSlaveEnable ( ) , 
随后 是 所 需 FIFO 配置 的 也 CSlaveFIFOEnable () 
返回 无 
表 F-42 I2CSlavelInit 
功能 初始 化 DC 的 从 机 模块 
函数 原型 void 12CSlaveInit ( uint32_t ui32Base, uint8_t ui8SlaveAddr) 
参数 ui32Base DPC 从 机 模块 的 基地 址 
ui8SlaveAddr 7 位 从 机 地 址 
描述 该 函数 通过 配置 从 机 地 址 与 使 能 2C 从 机 模块 来 初始 化 2C 从 机 模块 的 操作 
HS 参数 ui8SlaveAddr 为 与 DC 主机 发 送 的 从 机 地 址 进行 比较 的 值 
返回 元 
表 F-43 12CSlaveImtClear 
功能 清除 2C 从 机 的 中 断 源 
函数 原型 void I2CSlaveIntClear (uint32_t ui32Base) 
参数 ui32Base DC 从 机 模块 的 基地 址 
描述 清除 2C 从 机 的 中 断 源 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 中 被 调用 ， 防 止 在 退 
es 出 时 中 断 立 即 被 再 次 触发 
返回 无 
表 F-44 2CSlaveImtClearEx 
功能 清除 2C 从 机 的 中 断 源 
函数 原型 void 12CSlaveIntClearEx ( uint32_t ui32Base, uint32_t ui32IntFlags ) 
参 数 un32Base DC 从 机 模块 的 基地 址 
a ui32IntFlags ” 待 清除 的 中 断 源 的 屏蔽 位 
描述 清除 指定 2C 从 机 的 中 断 源 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 中 被 调用 ， 防 
止 在 退出 时 中 断 立 即 被 再 次 触发 
返回 无 
表 F-45 I2CslaveIntDisable 
功能 禁止 DC 从 机 的 中 断 
函数 原型 void 12CSlaveIntDisable (uint32_t ui32 Base ) 
参数 ui32Base DC 从 机 模块 的 基地 址 
描述 该 函数 禁止 DC 从 机 的 中 断 源 
返回 元 
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表 F-46 12CslaveIntDisableEx 




































































































































































功能 禁止 単 休 DC 从 机 的 中 断 源 
函数 原型 void DPCSlaveIntDisableFx ( uint32_t ui32Base, uint32_t ui32 IntFlags ) 
参 数 ui32Base I2C 从 机 模块 的 基地 址 
= ui32IntFlags ” 待 清除 中 断 源 的 屏蔽 位 
描述 该 函数 清除 指定 2C 从 机 的 中 断 源 。 只 有 使 能 这 个 中 断 源 才 会 反映 到 处 理 器 中 断 ; 禁止 
的 中 断 源 不 会 影响 处 理 器 
返回 无 
表 F-47 I2CslaveIntEnable 
功能 使 能 DC 从 机 的 中 断 
函数 原型 void DPCSlaveIntEnable (uint32_t ui32Base) 
参数 ui32Base DC 从 机 模块 的 基地 址 
描述 该 函数 使 能 DC 从 机 的 中 断 源 
返回 无 
表 F-48 I2CslaveIntEnableEx 
功能 使 能 单个 DC 从 机 的 中 断 源 
函数 原型 void I2CSlaveIntEnableEx (uint32_t ui32Base，uint32_t ui32IntFlags ) 
参数 ui32Base 12C 从 机 模块 的 基地 址 
u32IntFlags ” 待 清除 中 断 源 的 屏蔽 位 
该 函数 使 能 指定 12C 从 机 的 中 断 源 。 只 有 使 能 这 个 中 断 源 才 会 反映 到 处 理 器 中 断 ; 禁止 
的 中 断 源 不 会 影响 处 理 器 
参数 uilntFlags 为 下 值 任意 的 逻辑 或 . 
> 2C_SLAVE_INT RX > _FIFO_FULL //RX FIFO 満 中 断 
> 12C_SLAVE_INT_TX_FIFO_EMPTY //TX FIFO 空中 断 
描述 > DPC_SLAVE_INT_RX_FIFO_REQ //RX FIFO 请 求 中 断 
Me > DC_SLAVE_INT_TX_FIFO_REQ //TX FIFO 请 求 中 断 
> DPC_SLAVE_INT_TX_DMA_DONE //TX DMA 完成 中 断 
> 12C_SLAVE_INT RX_DMA_DONE //RX DMA 完成 中 断 
> 2C_SLAVE_INT_STOP // 停 止 检测 条 件 中 断 
> 2C_SLAVE_INT_START // 开 始 检测 条 件 中 断 
> DC_SLAVE_INT_DATA // 数 据 中 断 
返回 无 
表 F-49 I2CslaveIntStatus 
功能 获取 当前 LC 从 机 的 中 断 状态 
7 四 電 | bool 12CSlaveIntStatus (uint32_t ni32 Base , 
函数 原型 bool bMasked) 
nm32Base 1I2C 从 机 模块 的 基地 址 
参 数 bMasked ” 若 要 求 原始 的 中 断 状态 ， 则 bMasked 为 false; 若 需 要 屏蔽 的 中 断 状 态 ， 则 bMasked 
为 true 
要 该 函数 返回 DC 从 机 模块 的 中 断 状态 。 可 返回 原始 中 断 状态 或 允许 反映 到 处 理 器 中 的 中 
a 断 状态 
返回 返回 当前 的 中 断 状 态 ， 如 果 激 活 返回 bue， 如 果 未 激活 返回 false 
表 F-50 12CslaveIntStatusEx 
功能 获取 当前 2C 从 机 的 中 断 状 态 
画数 原型 uint32_t 12CSlaveIntStatusEx ( uint32_t ui32 Base , 





bool bMasked ) 
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( 续 ) 
























































































































































ui32Base I2C 从 机 模块 的 基地 址 
参数 bMasked ”车 要 求 原始 的 中 断 状态 ， 则 bMasked 为 false; 若 需 要 屏蔽 的 中 断 状态 ， 则 
bMasked 为 true 
描述 该 函数 返回 DC 从 机 模块 的 中 断 状态 。 可 返回 原始 中 断 状态 或 允许 反映 到 处 理 器 中 的 中 
返回 返回 当前 中 断 状态 ， 枚 举 I2CSlaveIntEnableEx( ) 中 描述 的 位 字段 的 值 
表 F-51 D2CSlaveStatus 
功能 获取 2C 从 机 模块 的 状态 
函数 原型 uint32_t PCSlaveStatus (uint32_t ui32 Base ) 
参数 ui32Base I2C 主机 模块 的 基地 址 
这 个 函数 返回 主机 请 求 的 动作 ， 可 能 的 取 值 如 下 : 
> DPC_SLAVE_ACT_NONE 
> DPC_SLAVE_ACT_RREQ 
描述 > DPC_SLAVE_ACT_TREQ 
> DPC_SLAVE_ACT_RREO_FBR 
> DPC_SLAVE_ACT_OWN2SEL 
> DPC_SLAVE_ACT_QCMD 
> DPC_SLAVE_ACT_QCMD_DATA 
返回 值 如 下 : 
> DPC_SLAVE_ACT_NONE // 没 有 任何 2C 从 机 模块 的 操作 被 请 求 
> DPC_SLAVE_ACT_RREQ /DPC 主机 已 经 把 数据 发 送 给 12C 从 机 模块 
> 2C_SLAVE_ACT_TREO //12C 主机 已 经 请 求 DC 从 机 模块 发 送 数据 
返回 > DPC_SLAVE_ACT_RREQ_FBR //I2C 主机 已 经 发 送 数据 到 2C 从 机 ; 并 且 已 接 收 
// 到 跟 在 从 机 自身 地 址 后 的 第 一 个 字 节 
> 2C_SLAVE_ACT_ OWN2SEL // 第 二 个 12C 从 机 地 址 被 匹配 
> 12C_SLAVE_ACT_OCMD // 已 收 到 快捷 命令 
> DPC_SLAVE_ACT_QCMD_DATA ”// 在 收 到 快捷 命令 时 数据 位 已 被 设置 
表 F-52 I2CTxFIFOConfigSet 
功能 配置 DC 发 送 (TX) FIFO 
-光正 刑 void DPCTxFIFOConfigSet (uint32_t ui32Base， 
函数 原型 uint32_t ui32Config ) 
参 数 ui32Base 12C 主机 或 从 机 模块 的 基地 址 
ui32Config 使 用 指定 的 宏 配置 FIFO 
配置 2C 外 设 的 发 送 FIFO。 发 送 FIFO 可 被 主机 或 从 机 使 用 , 但 二 者 不 能 同时 使 用 。 以 
下 宏 用 于 配置 带 或 不 带 DMA 的 主机 或 从 机 的 TX FIFO 行为 : 
> DPC_FIFO_CFG_TX_SLAVE 
> DPC_FIFO_CFG_TX_MASTER 
> DPC_FIFO_CFG_TX_SLAVE 
> DPC_FIFO_CFG_TX_MASTER_DMA 
> DPC_FIFO_CFG_TX_SLAVE_DMA 
描述 下 列 的 一 个 宏 将 用 于 选择 FIFO 的 触发 深度 : 
人 > 2C_FIFO_CFG_TX_TRIG_1 
> DPC_FIFO_CFG_TX_TRIG 2 
> DC_FIFO_CFG_TX_TRIG 3 
> DPC_FIFO_CFG_TX_TRIG 4 
> DPC_FIFO_CFG_TX_TRIG 5 
> DC_FIFO_CFG_TX_TRIG 6 
> DPC_FIFO_CFG_TX_TRIG 7 
> DC_FIFO_CFG_TX_TRIG 8 
返回 无 
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表 F-53 I2CTxFIFOFlush 














功能 刷新 发 送 (TX) FIFO 

函数 原型 void DPCTxFIFOFlush (uint32_t ui32Base) 
参数 ui32Base PC 主机 或 从 机 模块 的 基地 址 
描述 该 函数 刷新 12C 的 发 送 FIFO 

返回 无 








附录 G 第 9 章 附 录 :SSI 固件 


本 章 附 录 将 简要 介绍 SSI 的 固件 库 函 数 。 


表 G-1 SSIAdvDataPutFrameEnd 


py 


函数 简介 















































































































































功能 把 一 个 作为 帧 结束 的 数据 单元 存放 到 SSI 发 送 FIFO 中 
函数 原型 void SSIAdvDataPutFrameEnd ( uint32_t ni32 Base , uint32_t ni32Data ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
过 ui32Data 在 SSI 接口 待 数 据 传 输 

该 函数 将 提供 的 数据 保存 到 指定 SSI 模块 的 发 送 FIFO 中 ， 并 标记 为 一 个 帧 的 结束 。 如 
描述 果 在 发 送 FIFO 中 没有 可 用 的 空间 ， 这 个 函数 将 一 直 等 待 直到 有 可 用 的 空间 方 可 返回 。 在 

这 个 字 节 由 SSI 模块 传送 完 之 后 ， 应 禁止 FSS 信号 至 少 一 个 SSI 时 钟 
返回 参数 无 
表 G-2 SSIAdvDataPutFrameEndNonBlocking 

功能 把 一 个 作为 帧 结束 的 数据 单元 存放 到 SSI 发 送 FIFO 中 
ー と | int32_t SSIAdvDataPutFrameEndNonBlocking (uint32_t ui32Base, 
函数 原型 uint32_t ui32Data ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
A ui32Data 在 SSI 接口 待 传输 的 数据 

该 函数 将 提供 的 数据 保存 到 指定 SSI 模块 的 发 送 FIFO 中 ， 并 标记 为 一 个 帧 的 结束 。 在 
描述 这 个 字 节 由 SSI 模块 传送 完 之 后 ， 应 禁止 FSS 信号 至 少 一 个 SSI 时 钟 。 如 果 在 发 送 FIFO 中 

没有 可 用 的 空间 ， 这 个 函数 将 返回 0 
返回 参数 返回 写 入 SSI 发 送 FIFO 的 単元 人 数 
表 G-3 SSIAdvFrameHoldDisable 
功能 配置 SSI 的 高 级 模式 以 在 每 个 字 节 传输 后 关闭 SSIFss 信号 
函数 原型 void SSIAdvFrameHoldDisable (uint32_t ui32Base ) 
参 数 ui32Base SSI 端口 的 基地 址 
描述 在 每 个 字 节 传输 完 之 后 ， 该 函数 使 用 一 种 高 级 模式 配置 SSI 模块 ， 以 关闭 SSIFss 信号 一 
ms 个 SSI 时 钟 周期 ， 这 种 模式 为 默认 操作 
返回 参数 无 
表 G-4 SSIAdvFrameHoldEnable 

功能 配置 SSI 高 级 模式 以 在 整个 传输 期 间 保持 SSIFss 信号 
函数 原型 Void SSIAdvFrameHoldEnable (uint32_t 32 Base ) 
参 数 ui32Base SSI 端口 的 基地 址 
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该 函数 配置 SSI 模块 使 


























( 续 ) 


种 高 级 模式 以 在 整个 数据 传输 中 保持 SSIFss 信号 。 使 用 该 模式 ， 
























































































































































































































































描述 可 直接 通过 SSIAdvDataPutFrameEnd( ) 和 SSIAdvDataPutFrameEndNonBlocking( ) 来 控制 SSIFss 
返回 参数 无 
表 G-5 SSIAdvModeSet 
功能 选择 SSI 模块 的 高 级 操作 模式 
函数 原型 void SSIAdvModeSet (uint32_t ui32Base, uint32_t ui32Mode) 
参数 ui32Base SSI 端口 的 基地 址 
= ui32Mode 使用 的 操作 模式 
该 函数 用 于 选择 SSI 模块 所 需 的 高 级 操作 模式 
可 供 选择 的 模式 如 下 : 
> SSI_ADV_MODE_LEGACY /禁止 高 级 模式 操作 ， 它 会 引起 遗留 或 向 后 兼容 操作 。 知 
选择 该 模式 ， 将 不 能 有 效 的 在 双 或 四 SPI 操作 中 切换 。 该 模式 为 默认 
> SSL ADV_MODE_WRITE /只 能 将 数据 写 人 到 从 机 的 高 级 操作 模式 ; 任何 数据 会 定 
描述 时 通过 SSIRx 引 脚 扔 掉 (而 不 是 保存 到 SSI Rx FIFO 中 ) 
He > SSI_ADV_MODE_READ_WRITE /将 数据 写 入 到 从 机 或 读 出 从 机 数据 的 高 级 操作 模 
式 , 该 模式 与 ssi_adv_mode_legacy 相同 ， 但 允许 在 双 或 四 SPI 操作 中 切换 
>SSL ADV_MODE_BI READ /在 双 SPI 模式 中 读 出 来 自从 机 数据 的 高 级 操作 模式 ， 即 
每 个 SSI 时 钟 读 取 两 位 数据 
> SSI_ADV_MODE_BI_WRITE /在 双 SPI 模 式 中 将 数据 写 人 从 机 的 高 级 操作 模式 ， 即 
每 个 SSI 时 钟 写 人 两 位 数据 
> SSI_ADV_MODE_QUAD_READ // 在 四 SPI 模式 中 读 出 来 自从 机 数据 的 高 级 操作 模 
描述 式 ， 即 每 个 SSI 时 钟 读 取 四 位 数据 
> SSLADV_MODE_QUAD_WRITE // 在 四 SPI 模式 中 将 数据 写 入 从 机 的 高 级 操作 模式 ， 
即 每 个 SSI 时 钟 写 人 四 位 数据 
返回 参数 无 
表 G-6 SSIBusy 
功能 确认 SSI 发 送 器 是 否 忙碌 
函数 原型 bool SSIBusy (uint32_t 32 Base ) 
参 数 ui32Base SSI 端口 的 基地 址 
描述 此 函数 允许 调用 者 确定 是 否 所 有 的 传输 字 节 已 清除 了 发 送 器 硬件 。 如 果 返 回 false， 则 发 
送 FIFO 为 空 ， 并 且 最 后 发 送 字 的 所 有 位 都 已 从 硬件 移 位 寄存 器 中 移出 
返回 参数 如 果 返 回 true， 则 SSI 正在 发 送 ; 如 果 返 回 false， 则 所 有 传输 已 经 完成 
表 G-7 SSIClockSourceGet 
功能 获取 指定 SSI 外 设 的 数据 时 钟 源 
函数 原型 uint32_t SSIClockSourceGet (uint32_t ui32 Base ) 
参 数 ui32Base SSI 端口 的 基地 址 
描述 该 函数 返回 指定 SSI 外 设 的 数据 时 钟 源 
返回 参数 返回 当前 的 时 钟 源 (SSL_ CLOCK_SYSTEM 或 SSI CLOCK_PIOSC) 
表 G-8 SSIClockSourceSet 
功能 设置 指定 SSI 外 设 的 数据 时 钟 源 
函数 原型 void SSIClockSourceSet (uint32_t ui32Base, uint32_t ui32Source ) 
参数 ui32Base SSI 端口 的 基地 址 








ui32Source SSI 的 





波 特 率 时 钟 源 
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( 续 ) 
该 函数 允许 选择 SSI 波 特 率 的 时 钟 源 。 可 能 的 波 特 率 时 钟 源 为 系统 时 钟 (SSI_CLOCK_ 
SYSTEM) 或 内 部 精确 振荡 器 (SSL CLOCK_PIOSC ) 
更 改 波 特 率 时 钟 源 会 改变 SSI 产 生 的 数据 传输 速率 ， 因 此 更 改 波 特 率 的 时 钟 源 需 重新 配 
置 波 特 率 














功能 


无 


表 G-9 SSIConfigSetExpClk 
配置 同步 品行 接口 (SSI ) 








函数 原型 


void SSIConfigSetExpClk (uint32_t ui32Base， 
uint32_t ui32SSIClk ， 
uint32_t ui32 Protocol , 
uint32_t ui32 Mode, 
uint32_t ui32 BitRate, 
uint32_t ui32 DataWidth ) 

















ui32Base SSI 端口 的 基地 址 

ui32SSICIk ”提供 给 SSI 模块 的 时 钟 速率 
ui32Protocol ”指定 数据 传输 协议 
ui32Mode 指定 操作 模式 

ui32BitRate ”指定 时 钟 速率 
ui32DataWidt - h 指定 每 帧 传输 的 位 数 








该 函数 配置 SSI、 设 置 SSI 协议 、 操 作 模式 、 位 速率 和 数据 宽度 
参数 ui32Protocol 定义 数据 帧 格式 ， 其 值 可 选 如 下 之 一 : 
> SSI_FRF_MOTO_MODE 0 
> SSI_ FRF_MOTO_MODE 1 
> SSI_ FRF_MOTO_MODE 2 
> SSI_ FRF_MOTO_MODE 3 
> SSI_ FRF_TI 
> SSI FRF_NMW 
摩托 罗拉 的 帧 格式 编码 根据 以 下 的 极 性 和 相位 配置 ; 
极 性 〈Polarity) 相位 (Phase) 模式 
0 SSL_ FRF_MOTO_MODE_0 
1 SSI FRF_MOTO_MODE_1 
0 SSI FRF_MOTO_MODE_2 
1 SSL FRF_MOTO_MODE_3 
参数 32Mode 定义 了 SSI 模块 的 操作 模式 
SSI 模块 既 可 配置 为 主机 模式 也 可 配置 为 从 机 模式 ; 当 作 为 从 设备 时 ，SSI 可 配置 为 禁止 
其 串 行 输出 线 输出 
参数 ui32Mode 可 选 以 下 值 之 一 : 
> SSL MODE_MASTER，SSL MODE_SLAVE 
> SSL MODE_SLAVE_OD 
参数 ui32BitRate 定义 了 SSI 的 比特 率 
该 位 速率 必须 满足 以 下 时 钟 比 条 件 : 
> FSSI=2 + 位 速率 ( 主 模式 ) // 这 个 速度 不 能 超过 25 MHz 
> FSSI=12 + 位 速率 或 者 6 x 位 速率 (从 模式 ) /取决 于 特定 微 控 制 器 的 特性 
其 中 FSSI 是 SSI 模块 提供 的 时 钟 的 频率 
参数 ui32DataWidih 定义 了 传输 数据 的 宽度 ， 其 值 为 4 ~ 16 
这 里 ， 外 设 时钟 和 处 理 器 时 钟 相同 。 如 果 它 是 一 个 已 知 常 数 (调用 SysCtlClockGet( ) 来 
节约 编码 /执行 的 开销 ) ， 该 值 由 SysCtlClockGet( ) 返回 ， 或 者 它 为 显 式 地 硬 编码 
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功能 


无 


表 G-10 SSIDataGet 
从 SSI 接收 FIFO 中 获取 数据 单元 





函数 原型 





void SSIDataGet (uint32_t ui32Base, uint32_t * pui32Data ) 
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ui32Base 指定 SSI 端口 的 基地 址 








( 续 ) 








































































































































































































参 妆 6 = 
参 数 pu32Data 指向 SSI 端口 接收 数据 存储 单元 的 指针 
描述 该 函数 从 指定 SSI 模块 的 接收 FIFO 中 获取 接收 到 的 数据 ， 并 把 数据 存放 到 由 pui32Data 
aa 参数 指定 的 地 址 中 。 若 没有 可 用 的 数据 ， 该 函数 将 一 直 等 待 到 接收 到 数据 方 可 返回 
返回 参数 无 

表 G-11 SSIDataGetNonBlocking 
功能 从 SSI 模块 接收 FIFO 中 读 取 数据 元 素 
ー | int32_t SSIDataCetNonBlocking (uint32_t ui32Base, 
函数 原型 uint32_t * pui32Data) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
pu32Data 指向 SSI 端口 接收 数据 存储 单元 的 指针 
描述 该 函数 从 指定 SSI 模块 的 接收 FIFO 中 获取 接收 到 的 数据 ， 并 把 数据 存放 到 由 pui32Data 
> 参数 指定 的 地 址 中 。 如 果 FIFO 中 没有 数据 ， 则 该 函数 将 返回 0 
返回 参数 返回 从 SSI 接收 FIFO 中 读 取 的 数据 单元 的 个 数 

表 G-12 SSIDataPut 

功能 把 数据 单元 存放 到 SSI 发 送 FIFO 中 
函数 原型 void SSIDataPut (uint32_t ui32Base, uint32_t ui32Data ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
ui32Data ” 待 从 SSI 端口 发 送 的 数据 
描述 该 函数 把 提供 的 数据 存放 到 指定 SSI 模块 的 发 送 FIFO 中 。 如 果 在 发 送 FIFO 中 没有 可 用 
二 的 数据 ， 该 函数 将 一 直 等 待 到 接收 到 数据 方 可 返回 
返回 参数 无 

表 G-13 SSIDataPutNonBlocking 
功能 把 一 个 数据 单元 存放 到 SSI 发 送 FIFO 中 
一 i int32_t SSIDataPutNonBlocking (uint32_t ui32Base, 
函数 原型 uint32_t ui32Data ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
2 ui32Data 待 从 SSI 端口 发 送 的 数据 
描述 该 函数 把 提供 的 数据 存放 到 指定 SSI 模块 的 发 送 FIFO 中 。 如 果 在 发 送 FIFO 中 没有 可 用 
a 的 数据 ， 则 该 函数 将 返回 0 
返回 参数 返回 写 人 到 SSI 发 送 FIFO 中 的 数据 单元 的 个 数 

表 G-14 SSIDisable 

功能 禁止 同步 串 行 接口 
函数 原型 void SSIDisable (uint32_t ui32Base ) 
参数 ui32Base SSI 端口 的 基地 址 
描述 该 函数 禁止 同步 串 行 接口 的 操作 
返回 参数 无 
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表 G-15 SSIDMADisable 





















































































































































功能 禁止 SSI DMA 操作 
ーー 電 void SSIDMADisable (uint32_t ui32Base 
函数 原型 uint32_t ui32DMAFlags ) 
参 数 ui32Base SSI 端口 的 基地 址 
a ui32DMAFlags 禁止 DMA 功能 的 位 屏蔽 
该 函数 用 于 禁止 由 SSIDMAEnable( ) 使 能 的 指定 SST DMA 功能 
描述 参数 m32DMAFlags 是 下 列 任意 值 的 逻辑 或 ， 
Ne > SSLDMA_RX // 禁止 DMA 接收 
> SSLDMA_TX // 禁止 DMA 发 送 
返 回 参 数 无 
表 G-16 SSIDMAEnable 
功能 使 能 SSI DMA 操作 
函数 原型 void SSIDMAEnable (uint32_t ni32Base , uint32_t ui32DMAFlags ) 
参 数 ui32Base SSI 端口 的 基地 址 
2 ui32DMAFlags ”使 能 DMA 功能 的 位 屏蔽 
该 函数 使 能 指定 SSI DMA 功能 。SSI 可 以 配置 为 使 用 DMA 进行 数据 发 送 和 /或 接收 
描述 参数 ui32DMAFlags 为 下 列 任意 值 的 逻辑 或 : 
和 と SSIDMA_RX // 使 能 DMA 接收 
>SSI DMA_TX // 使 能 DMA 发 送 
返 回 参 数 无 
表 G-17 SSIEnable 
功能 使 能 同步 串 行 接口 模块 
函数 原型 void SSIEnable (uint32_t ui32 Base ) 
参 数 ui32Base 指定 SS1 端口 的 基地 址 
描述 该 函数 使 能 SSI 模块 的 操作 ，SSI 必须 在 使 能 前 配置 
返回 参数 无 
表 G-18 SSIIntClear 
功能 清除 SSI 中 断 来 源 
函数 原型 void SSIIntClear (uint32_t ui32Base, uint32_t ui32 IntFlags ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 
加 ui32IntFlags 待 清除 中 断 源 的 位 屏蔽 
清除 指定 SS 的 中 断 源 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 调用 ， 以 防止 在 退 
描述 出 时 中 断 再 次 被 触发 
参数 ui32IntFlags 可 包含 SSI_RXTO 与 SSL_RXOR 值 的 一 个 或 两 个 
返回 参数 无 
表 G-19 SSIIntDisable 
功能 禁止 单个 的 SSI 中 断 源 
函数 原型 void SSIIntDisable (uint32_t ui32Base, uint32_t ui32 IntFlags ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 








ui32IntFlags 禁止 中 断 源 的 位 屏蔽 
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该 函数 禁止 指示 的 SSI 中 断 源 
参数 ui32IntFlags 可 以 是 以 下 任 一 值 : 
> SSI_TXFF 

描述 > SSI_RXFF 

> SSI_RXTO 

> SSI_RXOR 
返回 参数 无 

表 G-20 SSIIntEnable 

功能 使 能 单个 SSI 模块 的 中 断 源 
函数 原型 void SSIIntEnable (uint32_t ui32Base, uint32_t ui32IntFlags ) 
参数 ui32Base 指定 SSI 端口 的 基地 址 





ui32 IntFlags 使 能 中 断 源 的 位 屏蔽 




















该 函数 使 能 SSI 中 断 源 指示 。 只 有 被 使 能 的 中 断 源 才能 反应 到 处 理 器 中 断 中 ; 被 禁止 的 
中 断 源 对 处 理 器 没有 影响 
参数 ui32IntFlags 为 以 下 任 一 值 : 
描述 > SSI_TXFF 
> SSI_RXFF 
> SSI_RXTO 
> SSI_RXOR 




















返回 参数 无 
表 G-21 SSIIntRegister 
功能 给 SSI 注册 一 个 中 断 处 程序 
函数 原型 void SSIIntRegister (uint32_t ui32Base, void ( * pfnHandler ) ( void ) ) 
参 数 u32Base 指定 SSI 端口 的 基地 址 
pfnHandler 指向 SSI 中 断 色 生 時 被 週 函数 的 指針 











当 产 生 SSI 中 断 时 ， 该 函数 将 注册 一 个 被 调用 的 中 断 处 理 程序 。 该 函数 使 能 中 断 控制 器 























描述 中 的 全 局 中 断 ; 特定 SSI 中 断 必须 由 SSIIntEnable( ) 函数 使 能 。 若 需要 ， 中 断 处 理 程序 还 
将 使 用 SSIIntClear( ) 来 清除 中 断 源 
返回 参数 无 








表 G-22 SSIIntStatus 
功能 获取 当前 的 中 断 状态 





uint32_t SSIIntStatus (uint32_t ui32 Base , 


函数 原型 
函数 原型 bool bMasked ) 





ui32Base 指定 SSI 端口 的 基地 址 
参数 bMasked ”如 果 要 求 的 为 原始 中 断 状态 ， 则 bMasked 为 False; 若 所 需 的 为 屏蔽 中 断 状态 ， 
则 bMasked 为 True 





























该 函数 返回 指定 SSI 模块 的 中 断 状态 。 返 回 的 是 原始 中 断 状态 或 允许 反映 到 处 理 器 的 中 
断 状态 

返回 当前 中 断 状 态 ， 并 通过 以 下 的 位 字段 枚 举 出 来 ; 
返回 参数 > SSI_TXFF 





> SSI_RXEFF 
ヶ SSI_RXTO SSI_RXOR 
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表 G-23 SSIIntUnregister 






























































功能 注销 SSI 的 中 断 处 理 程序 

函数 原型 void SSIIntUnregister (uint32_t ui32Base) 

参数 u32Base 指定 SSI 端口 的 基地 址 

描述 在 产生 SSI 中 汤 时 ， 该 函数 将 清除 被 调用 的 中 断 处 理 程序 。 这 个 函数 同时 也 禁止 了 中 断 
控制 器 中 的 中 断 ， 使 中 断 处 理 程序 不 会 再 被 调 

返回 参数 无 








《% 附录 HH 第 10 章 附 录 : 内 部 存储 器 的 固件 库 函 数 简 介 


本 章 附 录 将 要 介绍 的 内 部 存储 器 固件 库 函 数 包括 : 
> H.1 闪存 (Flash) 的 固件 库 函 数 

> H.2 内 存 保护 单元 (MPU) 的 固件 库 函 数 

> H. 3 EEPROM 固件 库 函 数 


闪存 (Flash) 固件 库 函 数 


表 H-1 FashErase 


















































































































































功能 探 除 一 个 闪存 的 区 块 

函数 原型 int32_t FlashErase (uint32_t ni32 Address ) 

参 数 u32Address ” 待 擦 除 的 闪存 块 的 起 始 地 址 

描述 该 函数 将 删除 1KB 的 片上 闪存 区 块 。 闪 存在 擦 除 该 区 块 之 后 必须 被 填充 OxFF 字 他 ， 但 
只 读 与 只 执行 区 块 不 能 被 擦 除 。 且 只 有 当 区 块 被 擦 除 后 ,该 函数 才能 返回 

返回 参数 返回 0 表示 成功 , -1 表示 指定 的 块 地 址 无 效 ， 或 者 块 被 写 保护 

表 H-2 FlashIntClear 

功能 清除 闪存 控制 器 的 中 断 源 

函数 原型 void FlashIntClear (uint32_t ui32IntFlags) 

参数 ui32IntFlags ” 待 清除 中 断 源 的 位 屏蔽 ， 其 值 可 取 FLASH_INT_PROGRAM 或 FLASH_INT 
_AMISC 

描述 清除 指定 内 存 控制 器 的 中 断 源 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 中 被 调用 ， 
对 其 进行 调用 。 以 防止 在 退出 时 又 立即 被 再 次 被 触发 

返回 参数 无 

表 H-3 FashmtDisable 

功能 禁止 单个 闪存 控制 器 的 中 断 源 

函数 原型 void FlashIntDisable (uint32_t ui32IntFlags) 

参数 ui32IntFlags ” 待 禁 止 中 断 源 的 位 屏蔽 。 其 值 可 取 FLASH_INT_PROGRAM 或 FLASH_INT 
_ACCESS 

描述 该 函数 禁止 指定 内 存 控制 器 的 中 断 源 。 只 有 使 能 的 中 断 源 才能 被 反映 到 处 理 器 中 断 ; 禁 
止 的 中 断 源 对 处 理 避 无 影响 

返回 参数 无 
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表 H-4 FlashIntEnable 



















































































































































































































































































功 外 使 能 单个 闪存 控制 器 的 中 断 源 
函数 原型 voidFlashIntEnable (uint32_t ui32IntFlags) 
参 数 ui32IntFlags ” 待 使 能 中 断 源 的 位 屏蔽 。 其 值 可 取 FLASH_INT_PROGRAM 或 FLASH_INT 
四 _ACCESS 
描述 该 函数 使 能 指定 闪存 控制 器 的 中 断 源 。 只 有 使 能 的 中 断 源 才 能 被 反映 到 处 理 器 中 断 ; 禁 
人 止 的 中 断 源 对 处 理 器 无 影响 
返回 参数 无 
表 H-S FlashIntRegister 
功 人 注册 闪存 中 断 的 中 断 处 理 程序 
函数 原型 void FlashIntRegister (void ( * pfnHandler) (void) ) 
参数 pfnHandler 指向 在 闪存 中 断 发 生 时 被 调 函 数 的 指针 
在 闪存 中 断 发 生 时 ， 该 函数 用 于 设置 被 调用 的 中 断 处 理 程序 。 当 无 效 闪存 访问 发 生 时 ， 
描述 闪存 控制 器 将 会 发 出 一 个 中 断 。 在 编程 或 擦 除 操作 完成 时 ， 也 可 产生 中 断 。 并 且 在 注册 中 
断 处 理 程序 时 会 自动 使 能 该 中 断 
返回 参数 无 
表 H-6 FlashIntStatus 
功能 获取 当前 的 中 断 状态 
函数 原型 uint32_t FlashlntStatus (bool bMasked ) 
参 数 bMasked ” 若 要 求 原始 中 断 状态 ， 则 bMasked 为 false; 如 果 所 需 的 是 屏蔽 中 断 状 态 ， 则 
bMasked 为 rue 
描述 该 函数 将 返回 闪存 控制 器 的 中 断 状态 。 返 回 原始 中 断 状 态 或 允许 反映 到 处 理 器 中 的 中 断 状 态 
返回 当前 的 中 断 状态 ， 而 以 如 下 的 位 字段 枚 举 : 
返回 参数 > FLASH_INT_PROGRAM 
> FLASH_INT_ACCESS 
表 H-7 FlashIntUnregister 
功 全 注销 闪存 中 断 的 中 断 处 理 程序 
函数 原型 void FlashIntUnregister (void ) 
描述 该 函数 清除 闪存 中 断 发 生 时 被 调用 的 中 断 处 理 程序 。 该 函数 也 屏蔽 了 中 断 控制 器 中 的 中 
I 断 ， 以 使 中 断 处 理 程序 不 再 被 调 
返回 参数 无 
表 H-8 FlashProgram 
功能 闪存 编程 
int32_t FlashProgram (uint32 t *pui32Data , 
函数 原型 uint32_t ui32Address , 
uint32_t ui32Count ) 
pui32Data ”指向 待 编程 数据 的 指针 
参数 ui32Address ” 待 编程 闪存 的 开始 地 址 ， 其 必须 为 4 的 倍数 
ui32Count 待 编 程 的 字 节 数 ， 其 必须 为 4 的 倍数 。 
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( 续 ) 


























该 函数 将 一 组 字 编 程 到 片上 闪存 中 。 闪 存 页 中 的 每 个 字 在 每 次 擦 除 该 页 后 只 可 以 编程 一 
次 ; 多 次 编程 一 个 字 将 导致 该 字 所 在 的 闪存 中 出 现 不 可 预期 的 值 。 因 为 内 存 一 次 只 能 编程 












































描述 一 个 字 ， 且 起 始 地 址 和 字 节 数 都 必须 为 4 的 倍数 。 若 需要 ， 将 由 调用 者 来 验证 编程 的 内 容 
该 函数 只 有 在 数据 编程 结束 之 后 方 可 返回 
返回 参数 成 功 返 回 0， 若 过 到 编程 错误 ， 则 返回 -1 























表 H-9 FlashProtectGet 








































































































































































































功利 获取 闪存 块 保护 的 设置 
函数 原型 tlashProtection FlashProtectCet (uint32 t um32Address ) 
参数 ui32Address ” 待 查询 闪存 块 的 起 始 地 址 

该 函数 获取 指定 2KB 闪存 块 的 当前 保护 。 每 个 块 可 被 读 / 写 、 只 读 或 只 执行 。 读 / 写 块 可 
描述 被 读 取 、 执 行 、 擦 除 和 编程 ， 只 读 块 可 被 读 取 与 执行 ， 只 执行 块 只 可 被 执行 ， 而 不 允许 处 

理 器 和 调试 器 读 取 数 据 
返回 参数 返回 此 块 的 保护 设置 ， 可 能 的 取 值 请 参考 FlashProtectSet( ) 
表 H-10 FlashProtectSave 

功能 保存 闪存 的 保护 设置 
函数 原型 int32_t FlashProtectSave ( void ) 

该 函数 将 保存 当前 编程 内 存 保护 的 永久 配置 。 在 一 些 器 件 上 ， 该 操作 是 不 可 逆 的 ; 而 芯 
描述 片 复位 或 电源 周期 不 会 改变 

只 有 在 保存 保护 设置 以 后 ， 该 函数 方 可 返 
返回 参数 0 表示 成功 , -1 表示 遇 到 硬件 错误 
表 H-11 FlashProtectSet 

功能 设置 闪存 区 块 的 保护 设置 
函数 原型 int32_t FlashProtectSet (uint32_t ui32 Address , tFlashProtection eProtect) 

ui32 Address ” 待 保护 的 闪存 区 块 的 起 始 地 址 

eProtect ”应 用 于 块 的 保护 。 取 值 为 下 列 之 一 : 
参数 > FlashReadWrite 

> FlashReadOnly 

> FlashExecuteOnly 
描述 该 函数 为 指定 的 2KB 闪存 块 设置 保护 。 读 / 写 块 可 被 设置 成 只 读 或 只 执行 ; 只 读 块 也 可 
设置 成 只 执行 ;但 只 执行 块 不 能 修改 已 有 的 保护 设置 
返回 参数 0 表示 成功 , -1 表示 指定 的 地 址 或 保护 设置 无 效 

表 H-12 FlashUserGet 

功 生 获取 用 户 寄 存 器 
ー int32_t FlashUserCet (uint32_t *pui32User0 , 
函数 原型 uint32 t *pui32Userl) 
参数 pui32User0 ”指向 存放 用 户 寄存 器 0 单元 的 指针 
多 pui32Userl ”指向 存放 用 户 寄存 器 1 单元 的 指针 
描述 该 函数 读 取 用 户 寄存 器 (0 和 1) 的 内 容 ， 并 将 其 保存 到 指定 的 单元 
返回 参数 返回 0 表示 成功 , -1 表示 遇 到 硬件 错误 














437 


表 H-13 FlashUserSave 













































































功能 保存 用 户 寄 存 器 
函数 原型 int32_t FlashUserSave (void) 
描述 该 函数 将 保存 当前 编程 内 存 保护 的 永久 配置 。 在 一 些 器 件 上 ， 该 操作 是 不 可 逆 的 ; 芯片 
ee 复位 或 电源 周期 不 会 改变 闪存 的 保护 
返回 参数 无 
表 H-14 FlashUserSet 
功能 设 定 用 户 寄存 器 
函数 原型 int32_t FlashUserSet (uint32_t ui32User0 ，uint32_t un32 Userl ) 
参数 ui32User0 ”存储 在 用 户 寄存 器 0 的 值 
ui32Userl 存储 在 用 户 寄存 器 1 的 值 
描述 该 函数 将 用 户 寄存 器 的 (0 和 1) 内 容 设置 为 指定 的 值 
返回 参数 返回 0 表示 成功 , -1 表示 遇 到 硬件 错误 








内 存 保护 单元 (MPU) 固件 库 函 数 


本 小 节 将 介绍 MPU 的 固件 库 函 数 的 功能 。 


表 H-15 MPUDisable 















































































































































功能 禁止 使用 MPU 
函数 原型 voidMPUDisable (void ) 
描述 该 函数 禁用 Cortex - M 内 存 保护 单元 。 当 禁止 MPU 时 ， 使 用 默认 的 存储 器 映射 是 不 产生 
Ee 存储 器 管理 故障 
返回 参数 无 
表 H-16 MPUEnable 
功能 使 能 和 配置 MPU 的 使用 
函数 原型 voidMPUEnable (uint32_t m32MPUConfig ) 
参 数 u32MPUConfig 可 能 配置 的 逻辑 或 
该 函数 使 能 Cortex - M 内 存 保护 单元 。 配 置 特权 模式 下 的 默认 行为 ， 同 时 处 理 硬 故 障 或 
NMI。 在 使 能 MPU 之 前 ， 至 少 必须 调用 MPURegionSet ( ) 来 设置 一 个 区 域 ， 不 然 ， 将 MPU 
_CONFIG_PRIV_DEFAULT 标志 传递 给 MPUEnable ( ) 来 使 能 特权 模式 下 的 默认 区 域 。 一 旦 
使 能 MPU， 一 切 违 规 内 存 访问 ， 都 将 产生 存储 器 管理 故障 
参数 m32MPUConfig 应 为 以 下 任意 值 的 逻辑 或 : 
描述 > MPU_CONFIG_PRIV_DEFAULT// 在 特权 模式 下 与 无 其 他 区 域 定义 时 使 能 默认 存储 器 映 
射 。 当 使 能 MPU 时 ， 如 果 未 开启 此 选项 ， 则 必须 定义 至 少 一 个 有 效 区 域 
> MPU_CONFIG_HARDFLT_NMI// 在 发 生硬 故障 或 NMI 异常 处 理 时 使 能 MPU。 如 果 未 开 
启 此 选项 ， 当 其 中 的 一 个 异常 处 理 程序 和 应 用 了 默认 的 内 存 映 射 时 ， 将 禁止 MPU 
> MPU_CONFIG_NONE// 不 选择 上 述 选 项 。 在 这 种 情况 下 ， 特 权 模 式 不 提供 默认 的 存储 
器 映射 ， 并且 在 故障 处 理 程序 中 MPU 不 会 被 使 能 
返回 参数 无 
表 H-17 MPUIntRegister 
功能 注册 存储 器 管理 故障 的 中 断 处 理 程序 
函数 原型 voidMPUIntRegister (void ( *pfnHandler) ( void ) ) 
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( 续 ) 















































































































































































































































































































































参数 pfnHandler 指向 在 存储 器 管理 故障 发 生 时 被 调 函 数 的 指针 
描述 非法 访问 保护 区 将 使 MPU 产生 存储 器 管理 故障 ， 该 函数 用 于 设置 和 使 能 被 调用 的 处 理 
程序 
返回 参数 无 
表 H-18 MPUIntUnregister 
功能 注销 存储 器 管理 故障 的 中 断 处理 程 序 
函数 原型 void MPUIntUnregister ( void ) 
描述 该 函数 将 禁止 和 清除 在 存储 器 管理 故障 发 生 时 被 调用 的 处 理 程序 
返回 参数 无 
表 H-19 MPURegionCountGet 
功能 获取 MPU 支持 的 区 域 数 目 
函数 原型 uint32_tMPURegionCountGet (void) 
描述 该 函数 用 于 获取 MPU 所 支持 的 区 域 总 数 ， 包 括 已 编程 的 区 域 
返回 参数 使 用 MPURegionSet ( ) 进行 编程 的 可 用 存储 器 保护 区 的 数量 
表 H-20 MPURegionDisable 
功能 禁止 指定 的 区 域 
函数 原型 voidMPURegionDisable (uint32_t ui32Region ) 
参 数 un32Region 禁止 的 区 域 号 
描述 该 函数 用 于 禁止 先前 使 能 的 内 存 保护 区 域 。 如 果 未 另外 调用 MPURegionSet ( ) 来 覆盖 该 
Me 区 域 ， 则 此 区 域 的 配置 仍 将 保留 ， 并 且 可 通过 调用 MPURegionEnable ( ) 再 次 使 能 该 区 域 
返回 参数 无 
表 H-21 MPURegionEnable 
功能 使 能 指定 区 域 
函数 原型 voidMPURegionEnable (uint32_t m32Region ) 
参 数 ui32 Region 使 能 的 区 域 号 
描述 该 函数 用 于 使 能 存储 器 保护 区 域 。 该 区 域 已 使 用 MPURegionSet ( ) 函数 配置 过 。 一旦 使 
人 能 ， 该 区 域 的 存储 器 保护 规则 将 被 开启 ， 非 法 访问 将 导致 存储 器 管理 故障 
返回 参数 无 
表 H-22 MPURegionGet 
功能 获取 当前 指定 区 域 的 设置 
voidMPURegionCet (uint32_t ui32Region , 
函数 原型 uint32_t * pui32 Addr, 
uint32_t * pui32Flags ) 
ui32Region ”获取 的 区 域 号 
参数 pui32Addr 指向 区 域 基地 址 存放 单元 的 指针 
pui32Flags ”指向 区 域 属性 标志 的 指针 
该 函数 获取 指定 区 域 的 配置 。 参 数 的 含义 和 格式 与 MPURegionSet( ) 函数 相同 
描述 此 函数 用 于 保存 供 以 后 使 用 的 MPURegionSet( ) 函数 的 区 域 配置 。 该 区 域 的 使 能 状态 被 
保存 在 已 被 保存 的 属性 中 
返回 参数 无 
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功能 


设 


表 H-23 





MPURegionSet 


置 某 一 特定 区 域 的 访问 规则 





函数 原型 


void MPURegionSet (uint32_t ui32Region , 
uint32_t ui32Addr, 
uint32_t ui32Flags) 





ui32 Region 
ui32Addr 
ui32Flags 一 组 定义 区 域 上 





区 域 的 基地 址 


待 设置 的 区 域 号 
。 它 必须 按照 ui32Flags 指定 区 域 的 大 小 对 齐 
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I 属性 的 标志 











该 
小 ( 
参 
子 区 
标 
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VV 半 VVVVVVVVVVVVVVVVVVVVVVVVVvVYVYV 














函数 用 于 设置 一 个 区 域 的 保护 规则 。 该 区 域 具 有 一 个 基 址 、 一 组 属性 ， 以 及 区 域 的 大 














它 必 须 为 2 的 震 ) ， 划 











中 ， 基 址 参数 ui32Addr 必须 根据 








数 ui32Flags 是 所 有 区 域 属性 的 逻辑 或 。 它 是 区 域 大 小 、 
域 以 及 标志 的 结合 选择 来 决定 是 否 使 能 该 区 域 











志 大 小 决定 区 域 的 大 省 
MPU_RGN_SIZE_32B 
MPU_RGN_SIZE_64B 
MPU_RGN_SIZE_128B 
MPU_RGN_SIZE_256B 
MPU_RGN_SIZE_512B 
MPU_RGN_SIZE_1K 
MPU_RGN_SIZE_2K 
MPU_RGN_SIZE_4K 
MPU_RGCN_SIZE_SK 
MPU_RGN_SIZE_16K 
MPU_RGN_SIZE_32K 
MPU_RGCN_SIZE_64K 
MPU_RGN_SIZE_128K 
MPU_RGN_SIZE_256K 
MPU_RGCN_SIZE_S12K 
MPU_RGN_SIZE_1M 
MPU_RGCN_SIZE_2M 
MPU_RGN_SIZE_4M 
MPU_RGN_SIZE_SM 
MPU_RGN_SIZE_16M 
MPU_RGN_SIZE_32M 
MPU_RGN_SIZE_64M 
MPU_RGN_SIZE_128M 
MPU_RGN_SIZE_256M 
MPU_RGN_SIZE_S12M 
MPU_RGN_SIZE_1G 
MPU_RGN_SIZE_2C 
MPU_RGN_SIZE_4C 

















\， 并 且 必 须 为 以 下 之 一 : 





行 权限 标志 必须 是 下 列 之 一 : 
MPU_RGN_PERM_EXEC// 使 能 代码 执行 的 区 域 
MPU_RGN_PERM_NOEXEC /禁止 代码 执行 的 
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避 全 





E 特 权 模式 与 用 户 模式 




















MPU 将 区 域 











MPU_RGN_PERM_PRV_NO_USR_NO /无 特权 或 
MPU_RGN_PERM_PRV_RW_USR_N0// 特 权 读 / 写 ， 用 
MPU_RGN_PERM_PRV_RW_USR_RO// 特 权 读 / 写 ， 用 
MPU_RGN_PERM_PRV_RW_USR_RW// 特 权 读 / 写 ， 
MPU_RGN_PERM_PRV_RO_USR_N0O// 特 权 只 读 ， 用 户 不 能 访问 
MPU_RGN_PERM_PRV_RO_USR_RO// 特 权 只 读 ， 用 户 只 
动 分 割 成 8 个 大 小 相等 的 子 
区 域 的 任何 一 个 都 可 被 禁止 ， 人 允许 创建 的 “ 洞 ” 在 一 





区 域 大 小 对 齐 








执行 权限 、 读 / 写 权 限 、 禁 止 


下 ， 可 单独 应 用 读 / 写 访问 权限 。 读 / 写 访问 标志 必须 为 下 列 



































户 模式 访问 权限 
户 不 能 访问 
户 只 读 

用 户 可 读 / 写 


只 读 




















的 另 一 区 域 所 覆盖 。8 














区 域 。 子 区 域 仅 用 于 二 256B 的 区 域 。 这 8 











区 域 可 被 悬空 ， 或 被 具有 不 同 


个 子 区 域 中 的 任何 一 个 可 被 下 列 任何 标志 的 逻辑 或 所 禁止 : 





MPU_SUB_RGN_DISABLE_0 
MPU_SUB_RCN_DISABLE_1 
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> MPU_SUB_RGN_DISABLE 2 
> MPU_SUB_RGCN_DISABLE_3 
> MPU_SUB_RGN_DISABLE 4 
> MPU_SUB_RGN_DISABLE_S 

描述 > MPU_SUB_RGN_DISABLE 6 

> MPU_SUB_RGCN_DISABLE_7 
可 用 下 列 之 一 的 标志 开始 使 能 或 禁止 区 域 ; 
> MPU_RCN_ENABLE 
> MPU_RCN_DISABLE 

返 回 参 数 无 








EEPROM 固件 库 函 数 


本 小 节 将 以 定义 文档 和 函数 文档 两 部 分 来 介绍 EEPROM 的 固件 库 函 数 。 
1. 定义 文档 


表 H-24 EEPROM_INIT_ERROR 











































































































































































































定义 #define EEPROM_INIT_ERROR 
该 值 可 从 调用 EEPROMInit ( ) 函数 返回 。 它 这 表明 先前 的 数据 或 写 保护 操作 将 被 复位 事 
撒 述 件 所 中 断 ， 并 且 在 这 问题 发 生 之 后 将 使 EEPROM 外 设 无 法 被 清除 。 但 该 情况 可 用 另 一 次 
复位 来 解决 或 者 严重 依赖 问题 的 起 因 。 例 如 ， 如 果 部 分 电压 不 稳定 , 一旦 电压 稳定 之 后 便 
可 清除 该 错误 
表 H-25 EEPROM_INIT_OK 
定义 #define EEPROM_INIT_OK 
描述 该 值 可 从 调用 EEPROMImit ( ) 函数 返回 。 它 表明 先前 的 写 操作 没有 被 复位 事件 所 中 断 ， 
二 并 且 该 EEPROM 外 设 已 可 被 使 用 
表 H-26 EEPROM_ INIT_RETRY 
定义 #define EEPROM_INIT_RETRY 
此 值 可 从 调用 EEPROMInit ( ) 函数 返回 。 它 这 表明 先前 的 数据 或 写 保护 操作 将 被 复位 事 
描述 件 所 中 断 。 虽 然 EEPROM 外 设 已 经 恢复 其 状态 ， 但 上 次 的 写 操作 可 能 被 丢失 。 因 此 应 用 
程序 必须 检查 已 写 人 数据 的 有 效 性 ， 并 重 试 任何 需要 的 写 操作 
表 H-27 EEPROM_ INT_PROGRAM 
定义 #define EEPROM_INT_PROGRAM 
描述 如 果 正 在 发 出 一 个 EEPROM 中 断 的 信号 ， 这 个 值 可 以 传递 给 EEPROMIntEnable( ) 和 EE- 
Ps PROMIntDisable( ) ， 并 由 EEPROMIntStatus ( ) 返回 
表 H-28 EEPROM_PROT_NA_LNA_URW 
定义 #define EEPROM_PROT_NA_LNA_URW 
描述 该 值 可 传递 给 EEPROMBlockProtectSet( ) 或 从 EEPROMBlockProtectGet( ) 返回 。 它 表示 该 
Es 块 既 不 提供 读 也 不 提供 写 访问 ， 除 非 它 是 受 密码 保护 和 解锁 
表 H-29 EEPROM_PROT_RO_LNA_URO 
定义 #define EEPROM_PROT_RO_LNA_URO 
该 值 可 传递 给 EEPROMBlockProtectSet( ) 或 从 EEPROMBlockProtectGet( ) 返回。 它 表示 该 
描述 块 应 在 未 设置 密码 时 或 已 设置 密码 但 块 被 解锁 时 提供 只 读 访 问 。 当 已 设置 密码 且 块 被 锁 
定 ， 则 读 / 写 操作 将 被 禁止 
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表 H-30 EEPROM_PROT_RW_LRO_URW 














































































































































































































定义 #define EEPROM_PROT_RW_LRO_URW 
该 值 可 传递 给 EEPROMBlockProtectSet( ) 或 从 EEPROMBlockProtectGet( ) 返回。 它 表示 当 
描述 未 设置 密码 或 设置 了 密码 但 该 块 已 被 解锁 时 ， 该 块 应 提供 读 / 写 访问 ， 以 及 设置 了 密码 但 
块 锁定 时 可 提供 只 读 访 问 
表 H-31 EEPROM_PROT_SUPERVISOR_ONLY 
定义 #define EEPROM_PROT_SUPERVISOR_ONLY 
这 一 位 可 与 保护 选项 作 或 运算 后 传递 给 eepromblockprotectset( ) ， 或 从 eepromblockprotect- 
描述 get( ) 返回。 在 管理 员 模 式 下 限制 运行 EEPROM 访问 的 线程 ， 以 及 当 CPU 处 于 用 户 模 式 
时 ， 阻 止 访问 EEPROM 模块 
表 H-32 EEPROM_RC_INVPL 
定义 #define EEPROM_RC_INVPL 
描述 _ 该 返 可 码 位 (code bit) 表示 EEPROM 编程 状态 机 写 入 失败 (由 于 低 于 EEPROM 编程 所 
需 的 电压 )。 一旦 电压 稳定 该 操作 可 能 会 重 试 
表 H-33 EEPROM_RC_NOPERM 
定义 #define EEPROM_RC_NOPERM 
描述 该 返 回 码 位 表示 试图 写 人 一 个 值 站 但 是 目标 权 限 不 允许 写 操作 。 这 可 能 是 由 于 目标 块 被 
锁定 、 访 问 保护 设置 为 禁止 写 入 ,或 尝试 写 一 个 已 经 存在 的 密码 
表 H-34 EEPROM_RC_WKCOPY 
定义 #define EEPROM_RC_WKCOPY 
描述 该 返 1 码 位 表示 EEPROM 编程 状态 当前 正 复 制 到 或 从 内 部 复制 缓冲 区 ， 为 新 值 的 写 
入 创建 空间 。 这 可 作为 一 个 状态 指示 器 ， 但 不 显示 错误 
表 H-35 EEPROM_RC_WKERASE 
定义 #define EEPROM_RC_WKERASE 
指 洒 该 返回 码 位 表示 EEPROM 编程 状态 机 当前 正在 氛 除 内 部 复制 的 缓冲 区 。 这 可 作为 一 个 
状态 指示 器 ， 但 不 显示 错误 
表 H-36 EEPROM_RC_WORKING 
定义 #define EEPROM_RC_WORKING 
描述 该 返回 码 位 表示 EEPROM 编程 状态 机 正在 工作 。 直 到 清除 该 位 才能 尝试 新 的 写 操作 
表 H-37 EEPROM_RC_WRBUSY 
定义 #define EEPROM_RC_WRBUSY 
描述 该 返回 码 位 表示 在 写 操作 进行 时 ， 试 图 从 EEPROM 中 做 读 操作 
表 H-38 EEPROMAddrFromBlock 
功能 返回 EEPROM 模块 中 第 一 个 字 的 偏 移 地 址 
定义 #defineEEPROMAddrFromBlock (ui32Block ) 








( 续 ) 



















































































参数 ui32Addr 返回 EEPROM 模块 中 第 一 个 字 地 址 的 索引 
描述 该 宏 可 被 用 于 确定 给 定 EEPROM 模块 中 第 一 个 字 的 地 址 。 返 回 的 地 址 表示 EEPROM 存 
储 基 址 的 字 节 偏 移 量 
返回 返回 给 定 EEPROM 模块 第 一 个 字 的 地 址 
表 H-39 EEPROMBlockFromAddr 
功能 返回 包含 给 定 偏 移 地 址 的 EEPROM 块 号 
定义 #defineEEPROMBlockFromAddr (ui32Addr) 
参数 ui32Addr 返回 线性 的 、EEPROM 存储 单元 的 字 节 地 址 块 号 。 这 是 一 个 从 EEPROM 起 始 
ー 存储 单元 的 零 偏 移 量 
描述 该 宏 可 用 于 把 EEPROM 地 址 偏 移 转 换 成 一 个 块 号 ， 以 适用 于 任何 驱动 程序 的 块 保护 函 
Re 数 中 。 提 供 的 地 址 表示 EEPROM 基地 址 的 字 节 偏 移 量 
回 返回 包含 传递 地 址 从 零 开 始 的 块 号 





2. 函数 文档 








表 H-40 EEPROMBlockCountGet 





























































































































功名 确定 在 EEPROM 中 块 的 数量 
函数 原型 uint32_tEEPROMBlockCountGet ( void ) 

该 函数 可 用 来 确定 在 EEPROM 中 块 的 数量 。 每 个 块 有 相同 的 大 小 ， 在 一 个 块 中 包含 的 
描述 存储 字 节 数 由 设备 分 割 的 块 大 小 决定 ， 这 可 通过 调用 EEPROMSizeGet ( ) 函数 来 获取 ， 并 

通过 该 函数 返回 块 的 数量 
返回 返回 EEPROM 中 块 的 总 数 
表 H-41 EEPROMBlockHide 

功 外 在 下 次 复位 前 ， 隐 藏 EEPROM 块 
函数 原型 void EEPROMBlockHide (uint32_t ui32Block ) 
参 数 u32Block ” 待 隐 藏 的 EEPROM 块 号 

该 函数 隐藏 块 0 以外 的 EEPROM 块 。 一 旦 隐藏 ， 块 在 下 次 复位 前 是 完全 无 法 访问 的 。 这 
描述 种 机 制 允 许 初 始 化 代码 访问 被 隐藏 的 应 用 程序 其 余部 分 的 数据 。 不 同 于 使 用 密码 的 应 用 程 

序 ， 它 使 用 的 块 隐 藏 不 需要 包含 任何 可 通过 反 汇 编发 现 的 般 入 密码 
返回 无 
表 H-42 EEPROMBlockLock 

功 外 锁定 受 密码 保护 的 EEPROM 块 
函数 原型 uint32_tEEPROMBlockLock (uint32_t ui32Block ) 
参数 ui32Block ” 待 锁定 的 EEPROM 块 号 

该 函数 用 于 锁定 已 被 先前 写 和 密码 保护 的 EEPROM 块 。 访 问 被 锁定 的 块 由 以 前 调用 的 
描述 EEPROMBlockProtectSet ( ) 函数 应 用 的 保护 设置 来 决定 。 如 果 这 个 块 先前 没有 设置 密码 ， 
He 该 函数 没有 任何 影响 。 

锁定 块 0 具有 使 EEPROM 中 的 所 有 其 他 块 不 可 访问 的 效果 
返回 返回 退出 块 锁定 状态 。 如 果 未 锁定 返回 1; 如果 锁定 则 返回 0 
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表 H-43 EEPROMBlockPasswordSet 































































































































































































功能 设置 用 于 保护 EEPROM 块 的 密码 
uint32_tEEPROMBlockPasswordSet (uint32_t ui32Block, 
函数 原型 uint32_t * pui32Password , 
uint32_t ui32Count ) 
ui32Block ” 待 设置 密码 的 EEPROM 块 号 
参数 pui32Password 指向 由 uint32_t 值 构成 的 密码 设置 数组 的 指针 。 每 个 元 素 可 以 是 除了 
OxFFFFFFFF 以 外 的 任何 32 位 值 。 这 个 数组 必须 包含 由 mi32Count 参数 给 定 的 元 素数 量 
ui32Count 提供 ui32Password 中 uint32_t 的 数量 ， 有 效 的 值 为 1、2 
该 函数 允许 密码 用 于 解锁 被 设置 的 EEPROM 块 。 32 、64 或 96 位 任意 值 的 字 
组 成 (0xFFFFFFFF 除外 )。 密 码 只 能 设置 一 次 ， 任 何 进 一 步 尝 试 设置 密码 的 操作 将 导致 错 
误 。 一 旦 设置 了 密码 ， 该 块 或 块 0 在 调 EEPROMBIlockLock( ) 或 发 生 复位 以 前 ， 该 块 将 一 
描述 直 保 持 解锁 状态 
如 果 密 码 设置 在 块 0 上 ， 这 会 影响 整个 外 设 的 锁定 。 当 锁定 块 0 时 ， 在 块 0 解锁 前 ， 所 
有 其 他 EEPROM 块 将 无 法 访问 - 一 旦 块 0 解锁 ， 可 根据 设置 在 其 他 块 上 的 密码 来 访问 相应 
的 块 ， 该 块 的 保护 设置 可 通过 调用 EEPROMBlockProtectSet( ) 来 实现 
返回 下 列 一 个 逻辑 或 组 合 来 表示 状态 和 错误 条 件 : 
> EEPROM_RC_INVP 
> EEPROM_RC_WRBUSY 
返回 > EEPROM_RC_NOPERM 
> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 
表 H-44 EEPROMBlockProtectGet 
功 全 返回 EEPROM 块 的 当前 保护 等 级 
函数 原型 uint32_tEEPROMBlockProtectGet ( uint32_t ui32 Block ) 
参 数 u32Block ” 待 查询 的 保护 等 级 的 块 号 
描述 该 函数 返回 当前 给 定 EEPROM 块 的 保护 设置 。 若 当前 锁定 块 0， 则 必须 先 解锁 块 0， 然 
后 才能 调用 这 个 函数 来 查询 其 他 块 的 保护 设置 
返回 括号 内 任 选 其 中 一 个 值 (EPROM_PROT_RW_LRO_URW 、EEPROM_PROT_NA_LNA 
返回 _URW 、EEPROM_PROT_RO_LNA_URO ) 与 EEPROM_PROT_SUPERVISOR_ONLY 值 的 或 
表 H-45 EEPROMBlockProtectSet 
功能 设置 EEPROM 块 的 当前 保护 选项 
函数 原型 uint32_tEEPROMBlockProtectSet (uint32_t ui32Block, uint32_t ui32Protect ) 
un32Block ” 待 设置 保护 选项 的 块 号 
参数 nm32Protect ” 任 选 括号 内 其 中 一 个 值 ( EEPROM_PROT_RW_LRO_URW、EEPROM_ 





PROT_NA_LNA_URW 、EEPROM_PROT_RO_LNA_URO) 与 EEPROM_PROT_SUPERVI- 
SOR_ONLY 值 的 或 运算 
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岗 
回 





功能 





该 函数 设置 给 定 EEPROM 块 的 保护 设置 〈 假 设 先前 没有 保护 设置 被 写 人 ) 。 注 意 
以上 的 保 : 产 设置 是 和 加 在 块 0 的 保护 设置 之 上 的 ， 即 有 效 的 保护 设置 是 块 0 保护 标志 位 














( 续 ) 
注意 : 块 1 








及 
与 目标 块 保护 标志 位 的 逻辑 或 。 此 协议 允许 通过 块 0 设置 整个 设备 的 全 局 保护 选项 ， 更 严 
格 的 保护 设置 可 逐 块 设置 





保护 标志 指示 的 访问 权限 如 下 : 


> EEPROM_PROT_SUPERVISOR_ONLY /在 管理 员 模 式 下 限制 访问 块 的 线程 运行 。 若 





清除 此 标志 ， 月 


LU 


户 和 管理 员 线 程 都 可 以 访问 该 块 











> EEPROM_PROT_RW_LRO_URW // 若 块 未 设置 密码 ， 或 即使 设置 了 密码 但 块 已 被 解 
锁 ， 可 提供 块 的 读 / 写 访问 。 若 该 块 已 被 锁定 ， 则 仅 允 许 只 读 访 问 
> EEPROM_PROT_NA_LNA_URW / 既 不 提供 读 也 不 提供 写 访问 ， 除 非 设置 了 密码 的 块 

















被 解锁 。 若 块 已 解锁 ， 则 允许 该 块 的 读 取 和 写 入 访问 

















> EEPROM_PROT_RO_LNA_URO // 若 块 未 设置 密码 ， 或 块 设置 了 密码 但 已 被 解锁 ， 则 








提供 块 的 读 访问 。 如 果 块 设置 了 密码 保护 且 已 被 锁定 ， 则 不 允许 访问 该 块 











返回 下 列 值 组 合 的 一 个 逻辑 或 来 指示 状态 和 错误 条 件 : 
> EEPROM_RC_INVPL 

> EEPROM_RC_WRBUSY 

> EEPROM_RC_NOPERM 

> EEPROM_RC_WKCOPY 

> EEPROM_RC_WKERASE 

と EEPROM_RC_WORKING 








表 H-46 EEPROMBlockUnlock 
解锁 密码 保护 的 EEPROM 块 








函数 原型 


uint32_tEEPROMBlockUnlock (uint32_t ui32Block, 
uint32_t * pui32Password , 
uint32_t ui32Count) 





Wp 
洋 


BlockPasswordSet ( ) 来 使 每 


ui32Block ” 待 解锁 的 EEPROM 块 号 


pui32Password 指向 由 unt32_t 值 构成 的 密码 设置 数组 的 指针 。 可 通过 调用 EEPROM- 

















个 元 素 都 必须 与 原始 设置 的 密码 匹配 


ui32Count 提供 pui32Password 数组 中 的 元 素数 目 ， 且 必须 与 原始 传递 给 EEPROMBlock- 


Pa 





sswordSet ( ) 中 的 值 匹配 。 有 效 的 值 为 1、2 
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他 

















该 函数 用 于 解锁 EEPROM 块 先前 写 入 的 密码 保护 。 一 旦 块 被 解锁 ， 块 的 访问 就 取决 于 








前 调用 EEPROMBlockProtectSet ( ) 函数 所 设置 的 保护 





要 成 功 解锁 EEPROM 块 ， 提 供 的 密码 必须 与 EEPROMBlockPasswordSet ( ) 中 设置 的 原始 








码 匹 配 。 若 密码 不 正确 ， 块 将 保持 锁定 
解锁 块 0 将 使 所 有 其 他 块 可 根据 自己 的 访问 保护 设置 访 
EEPROM 块 将 不 能 被 访问 











问 设 备 。 当 块 0 锁定 时 ， 所 有 其 








所 
回 





功能 
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7 地 


返回 退出 时 的 锁定 状态 ， 如 果 返 回 1 代表 解锁 ,如 果 i 











表 H-47 EEPROMInit 
在 写 操 作 时 遭遇 电源 故障 所 执行 的 任何 必要 的 恢复 





























回 0 表示 锁定 





函数 原型 


uint32_tEEPROMInit (void ) 








在 
尽 





据 
过 
作 
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该 函数 必须 在 SysCtlPeripheralEnable( ) 之 后 ， 以 及 在 访问 EEPROM 前 调用 ， 以 检查 以 前 
写 操 作 时 由 于 电源 故障 造成 的 错误 。 该 函数 检测 这 些 错误 ， 并 在 返回 信息 给 调用 者 之 前 





可 能 的 恢复 这 些 错误 ， 无 论 先前 的 数据 是 否 丢失 都 必须 


重 试 



































返回 EEPROM_INIT_RETRY， 应 用 程序 负责 确定 哪个 写 数 据 可 能 已 丢失 ， 并 重 写 这 个 数 
。 如 果 返 回 EEPROM_INIT_ERROR， 则 EEPROM 将 无 法 恢复 其 状态 。 这 个 状况 能 否 通 























未 来 的 复位 解决 取决 于 故障 原因 。 例 如 ， 若 因 电 源 电压 不 稳定 ， 在 电压 稳定 后 ， 重 试 操 
可 能 会 清除 该 错误 。 在 复位 后 错误 的 调用 该 函数 可 能 导致 错 误 的 操作 ， 若 EEPROM 中 





























数据 是 以 后 写 入 的 可 能 使 其 永久 丢失 
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所 
回 


























若 未 检测 到 错误 ， 则 返回 EEPROM_INIT_OK;， 如 果 先 前 写 操作 被 电源 或 复位 寻 
断 ， 则 返回 EEPROM_INIT_RETRY; 若 EEPROM 外 设 目 前 无 法 恢复 中 断 的 写 入 或 擦 除 操 
作 ， 则 返回 EEPROM_INIT_ERROR 
































表 H-48 EEPROMIntClear 



































































































































































































































功 外 清除 EEPROM 中 断 
函数 原型 YoidEEPROMIntClear (uint32_t ui32IntFlags ) 
参数 ui32IntFlags “指示 待 清 除 的 中 断 源 ， 当 前 唯一 的 有 效 值 为 EEPROM_INT_PROGRAM 
描述 该 函数 允许 应 用 程序 清除 EEPROM 中 断 
返回 无 
表 H-49 EEPROMIntDisable 
功 角 禁止 EEPROM 中 断 
函数 原型 voidEEPROMIntDisable (uint32_t ui32IntFlags ) 
参数 ui32IntFlags 指示 待 禁止 的 EEPROM 中 断 源 ， 当 前 必须 为 EEPROM_INT_PROGRAM 
该 函数 禁止 EEPROM 中 断 ， 以 及 防止 当 任何 EEPROM 写 或 擦 除 操作 完成 时 调用 中 断 向 
描述 量 。EEPROM 外 设 共享 一 个 单一 的 中 断 向 量 与 闪存 子 系统 “INT_FLASH” 。 该 函数 提供 了 
一 种 方便 ， 可 通过 调用 FlashIntDisable ( ) ， 在 参数 ui32IntFlags 中 传递 FLASH_INT_EEP- 
ROM 来 禁止 EEPROM 中 断 
返回 无 
表 H-50 EEPROMIntEnable 
功能 使 能 EEPROM 中 断 
函数 原型 void EEPROMIntEnable (uint32_t ui32IntFlags) 
参 数 ui32IntFlags 指示 待 使 能 的 EEPROM 中 断 源 ， 当 前 必须 为 EEPROM_INT_PROCRAM 
描述 该 函数 使 能 EEPROM 中 断 。 使 能 时 ， 在 任何 EEPROM 写 或 擦 除 操作 完成 时 会 产生 一 个 
中 断 
返 回 无 
表 H-51 EEPROMIntStatus 
功能 EEPROM 中 断 状态 的 报告 
函数 原型 uint32_tEEPROMIntStatus (bool bMasked ) 
参数 bMasked 确定 是 否 屏蔽 返回 的 中 断 状态 。 如 果 bMasked 为 真 ， 返 回 屏蔽 状态 ， 否 则 返 
回 非 屏蔽 状态 
描述 该 函数 允许 应 程序 来 查询 EEPROM 的 中 断 状态 。 如 果 为 激活 状态 ， 可 通过 调用 EEP- 
ROMIntClear ( ) 来 清除 该 中 断 
返回 如 果 发 出 一 个 中 断 信号 返回 EEPROM_INT_PROGRAM， 否 则 返回 0 
表 H-52 EEPROMMassErase 
功能 擦 除 EEPROM 并 返回 到 出 厂 的 默认 状况 
函数 原型 uint32_tEEPROMMassErase ( void ) 
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( 续 ) 


该 函数 彻底 擦 除 EEPROM 包括 删除 所 有 块 的 访问 保护 ， 保 留 设 备 出 厂 时 的 默认 状态 。 
完成 该 操作 后 ， 所 有 的 EEPROM 字 由 值 0xFFFFFFFF 构成 ， 以 及 全 部 的 块 都 可 以 用 所 有 


































































































































































































述 i Sk i 
描述 CPU 模式 进行 读 / 写 操作 ， 并 且 不 包含 密码 
该 函数 与 擦 除 操作 同步 ， 只 有 在 擦 除 操作 完成 之 后 才 会 跳出 该 函数 
若 返回 0 表示 成 功 ; 返回 非 零 值 表示 失败 。 而 故障 代码 是 以 下 组 合 的 逻辑 或 : 
> EEPROM_RC_INVPL 
> EEPROM_RC_WRBUSY 
返 回 > EEPROM_RC_NOPERM 
> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 
表 H-S3 EEPROMProgram 
功能 写 入 数 据 到 EEPROM 中 
umnt32_tEEPROMProgram (mnt32_t * pni32Data , 
函数 原型 uint32_t ui32 Address , 
uint32_t ui32Count ) 
pui32Data 指向 待 写 入 到 EEPROM 数据 第 一 个 字 的 指针 
参 数 ui32Address ”定义 待 写 人 到 EEPROM 数据 的 字 节 地 址 ， 且 这 个 值 必须 是 4 的 倍数 
ui32Count 定义 该 写 入 数据 的 字 节 数 ， 且 这 个 值 必须 是 4 的 倍数 
描述 该 函数 可 用 于 在 一 个 给 定 的 字 对 齐 地 址 将 数据 写 入 到 EEPROM 中 
该 函数 与 擦 除 操作 同步 ， 只 有 在 擦 除 操作 完成 之 后 才 会 跳出 该 函数 
车 返回 0 表示 成 功 ; 返回 非 零 值 表示 失败 。 而 故障 代码 是 以 下 组 合 的 逻辑 或 ; 
> EEPROM_RC_INVPL 
> EEPROM_RC_WRBUSY 
返回 > EEPROM_RC_NOPERM 
> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 
表 H-54 EEPROMProgramNonBlocking 
功能 写 一 个 字 到 EEPROM 中 
る 7 本 人 0 unt32_tEEPROMProgramNonBlocking (uint32_t m32Data , 
函数 原型 uint32_t ui32 Address ) 
参数 ui32Data 待 写 人 到 EEPROM 中 的 字 
= ui32Address ”定义 待 写 人 到 EEPROM 中 数据 的 字 节 地 址 ， 且 这 个 值 必须 是 4 的 倍数 
该 函数 用 于 在 EEPROM 中 断 控制 下 编程 。 调 用 它 可 开始 在 给 定 的 字 对 齐 地址 写 一 个 字 
描述 的 数据 到 了 EEPROM 中 的 进程 。 这 个 调用 是 异步 的 ， 且 立即 返回 ， 无 需 等 待 写 人 完成 。 完 
成 上 述 操作 将 通过 EEPROM 模块 发 出 一 根 中 断 信 号 。EEPROM 外 设 共享 一 个 单一 的 中 断 
向 量 与 闪存 子 系统 “INT_FLASH” 
使 用 下 列 组 合 逻 辑 或 的 形式 ， 返 回 状态 和 错误 信息 : 
> EEPROM_RC_INVPL 
返回 > EEPROM_RC_WRBUSY 
> EEPROM_RC_NOPERM 
> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 
返回 以 下 标志 预示 操作 正常 ， 但 不 显示 错误 : 








> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 
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表 H-SS EEPROMRead 


功能 从 EEPROM 中 读 取 数据 





voidEEPROMRead (uint32_t * pui32Data, 
函数 原型 uint32_t ui32 Address , 
uint32_t ui32Count ) 














pui32Data 指向 从 EEPROM 中 读 出 数据 存储 单元 的 指针 。 该 指针 必须 指向 可 用 内 存 的 
参数 至 少 ui32Count 字 节 
= ui32 Address 从 EEPROM 中 读 取 数据 的 字 节 地 址 ， 且 这 个 值 必须 是 4 的 倍数 
ui32Count 从 EEPROM 中 读 取 数据 的 字 节 数 ， 且 这 个 值 必须 是 4 的 倍数 




















该 函数 用 于 在 EEPROM 中 从 字 对 齐 地 址 读 取 若干 个 字 的 数据 。 并 由 参数 pui32Data 指向 
































































































































述 Pe te 
描述 复制 到 缓冲 区 的 读 取 数据 
返回 无 
表 H-56 EEPROMSizeGet 
功能 确定 EEPROM 的 大 小 
函数 原型 uint32_tEEPROMSizeGet (void) 
描述 该 函数 返回 以 字 节 为 单位 的 EEPROM 大 小 
返回 返回 EEPROM 中 字 节 的 总 数 
表 H-S7 EEPROMStatusGet 
功能 返回 最 后 EEPROM 编程 或 擦 除 操作 的 状态 
函数 原型 uint32_tEEPROMSiatusCet (void) 
描述 该 函数 返回 由 EEPROM 执行 的 最 后 编程 或 擦 除 操作 的 当前 状态 。 其 目的 是 提供 应 用 程 
序 编 程 的 错误 信息 ， 或 在 中 断 控制 下 设置 EEPROM 的 保护 选项 
若 完 成 最 后 的 编程 或 擦 除 操作 没有 任何 错误 ， 则 返回 值 为 0。 如 果 操 作 正 在 进行 或 发 生 
错误 ,将 返回 下 列 值 组 合 的 逻辑 或 . 
> EEPROM_RC_INVPL 
返回 > EEPROM_RC_WRBUSY 
> EEPROM_RC_NOPERM 
> EEPROM_RC_WKCOPY 
> EEPROM_RC_WKERASE 
> EEPROM_RC_WORKING 








附录 I 第 11 章 附 录 ，GPTM 固件 库 函 数 简 介 


本 章 附 录 将 介绍 通用 定时 器 的 固件 库 函 数 。 


表 I-1 TimerADCEventGet 


py 

















功能 返回 可 引起 ADC 触发 事件 的 事件 
函数 原型 uint32 t TimerADCEventGet ( uint32_t um32 Base ) 
参 数 ui32Base ”定时 器 模块 的 基地 址 
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( 续 ) 

































































































































































































































































该 函数 返回 可 引起 一 个 ADC 触发 事件 的 定时 器 事件 。ADC 触发 事件 为 下 列 任何 值 的 逻 
辑 或 : 
> TIMER_ADC_MODEMATCH_B ” // 已 使 能 定时 器 B 的 模式 匹配 ADC 触发 
> TIMER_ADC_CAPEVENT_B // 已 使 能 定时 器 B 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_B // 已 使 能 定时 器 B 的 捕获 匹配 ADC 触发 
描述 > TIMER_ADC_TIMEOUT_B // 已 使 能 定时 器 B 的 超时 ADC 触发 
> TIMER_ADC_MODEMATCH_A ”// 已 使 能 定时 器 A 的 模式 匹配 ADC 触发 
> TIMER_ADC_RTC_A // 已 使 能 定时 器 A 的 RTC ADC 触发 
> TIMER_ADC_CAPEVENT_A // 已 使 能 定时 器 A 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_A // 已 使 能 定时 器 A 的 捕获 匹配 ADC 触发 
> TIMER_ADC_TIMEOUT_A // 已 使 能 定时 器 A 的 超时 ADC 触发 
返回 值 定时 器 触发 ADC 的 事件 
表 1-2 TimerADCEventSet 
功能 使 能 引起 ADC 触发 事件 的 事件 
函数 原型 void TimerADCEventSet (uint32_t ui32Base, uint32_t ui32ADCEvent) 
参数 ui32Base 定时 需 模 块 的 基地 址 
加 ui32ADCEvent 引起 ADC 触发 事件 的 位 屏蔽 
该 函数 使 能 引起 定时 器 ADC 触发 事件 的 事件 。 而 ADC 触发 事件 可 通过 下 列 任意 值 的 逻 
辑 或 运算 得 到 的 参数 ui32ADCEvent 指定 : 
> TIMER_ADC_MODEMATCH_B // 使 能 定时 器 B 的 模式 匹配 ADC 触发 
> TIMER_ADC_CAPEVENT_B // 使 能 定时 器 B 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_B // 使 能 定时 器 B 的 捕获 匹配 ADC 触发 
描述 > TIMER_ADC_TIMEOUT_B // 使 能 定时 器 B 的 超时 ADC 触发 
> TIMER_ADC_MODEMATCH_A // 使 能 定时 器 A 的 模式 匹配 ADC 触发 
> TIMER_ADC_RTC_A // 使 能 定时 器 A 的 RTC ADC 触发 
> TIMER_ADC_CAPEVENT_A // 使 能 定时 器 A 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_A // 使 能 定时 器 A 的 捕获 匹配 ADC 触发 
> TIMER_ADC_TIMEOUT_A // 使 能 定时 器 A 的 超时 ADC 触发 
返回 值 无 
表 I-3 TimerClockSourceGet 
功能 返回 指定 定时 器 模块 的 时 钟 源 
函数 原型 uint32 t TimerClockSourceGet (uint32_t m32Base) 
参数 ui32Base ”定时 器 模块 的 基地 址 
描述 该 函数 返回 指定 的 定时 器 模块 的 时 钟 源 。 候 选 的 时 钟 源 为 系统 时 钟 (TIMER_CLOCK_ 
Me SYSTEM) 或 内 部 精密 振荡 器 CTIMER_CLOCK_PIOSC) 
返回 值 要 么 返回 TIMER_CLOCK_SYSTEM， 要 么 返回 TIMER_CLOCK_PIOSC 
表 I-4 TimerClockSourceSet 
功能 设置 指定 的 定时 器 模块 的 时 钟 源 
函数 原型 uint32 t TimerADCEventGet ( uint32_t ui32Base) 
参 数 ui32Base 定时 需 模 块 的 基地 址 
描述 该 函数 设置 给 定 的 定时 器 模块 中 定时 器 A 和 定时 器 B 的 时 钟 源 。 候 选 的 时 钟 源 为 系统 时 
Es 钟 (TIMER_CLOCK_SYSTEM) 或 内 部 精密 振荡 器 (TIMER_CLOCK_PIOSC) 
返回 值 无 
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表 I-5 TimerConfigure 






























































































































































功能 配置 定时 器 
函数 原型 void TimerConfigure ( uint32_t ui32Base，uint32_t ui32Config) 
参 数 ui32Base ”定时 器 模 快 的 基地 址 
2 ui32Config 配置 定时 需 
该 函数 配置 定时 器 的 的 操作 模式 。 定 时 器 模块 在 配置 前 被 禁止 并 保持 禁止 状态 。 定 时 器 
可 用 TIMER_CFG_* 值 来 配置 成 一 个 单一 的 全 宽 定 时 器 ， 或 使 用 TIMER_CFG_A_* 和 TIM- 
ER_CFG_B_* 值 来 配置 成 一 对 半 宽 的 定时 器 来 传递 参数 ui32Config 
ui32Config 指定 的 配置 为 下 列 值 中 的 一 个 : 
> TIMER_CFG_ONE_SHOT // 全 宽 单 次 触发 定时 器 
> TIMER_CFG_ONE_SHOT_UP // 全 宽 单 次 递增 蔡 代 递 减 计数 定时 器 (不 是 所 有 
的 器 件 都 提供 ) 
> TIMER_CFG_PERIODIC // 全 宽 周 期 定时 器 
> TIMER_CFC_PERIODIC_UP // 例 宽 周期 递增 替代 递减 计数 定时 器 (不 是 所 有 
的 器 件 都 提供 ) 
> TIMER_CFG_RTC // 全 宽 实时 时 钟 定时 器 
> TIMER_CFG_SPLIT_PAIR // 2 个 半 宽 定时 央 
当 配 置 成 一 对 半 宽 定时 器 时 ， 每 个 定时 器 可 单独 配置 。 第 一 个 定时 器 通过 下 列 的 一 个 值 
和 m32Config 的 逻辑 或 操作 结果 来 配置 
描述 > TIMER_CFG_A_ONE_SHOT // 半 宽 单 次 触发 定时 器 
> TIMER_CFG_A_ONE_SHOT_UP ”// 半 宽 单 次 递增 替代 递减 计数 定时 器 (不 是 所 有 
的 部 件 都 提供 ) 
> TIMER_CFG_A_PERIODIC // 半 宽 周 期 定时 器 
> TIMER_CFC_A_PERIODIC_UP // 半 宽 周 期 递增 替代 递减 计数 定时 器 (不 是 所 有 
的 部 件 都 提供 ) 
> TIMER_CFG_A CAP COUNT // 半 宽 边 沿 计数 捕获 
> TIMER_CFG_A_CAP_COUNT_UP “”/ 半 宽 边 沿 递增 替代 递减 计数 捕获 (不 是 所 有 的 
部 件 都 提供 ) 
> TIMER_CFG_A_CAP_TIME // 半 宽 边 沿 时 间 捕 获 
> TIMER_CFG_A_CAP_TIME_UP // 半 宽 边 沿 递增 蔡 代 递 减 定时 捕获 (不 是 所 有 的 
部 件 都 提供 ) 
> TIMER_CFG_A_PWM // 半 宽 PWM 输出 
类 似 的 ， 第 二 个 定时 器 是 通过 将 m32Config 设置 为 一 个 相应 的 TIMER_CFG_B_* 值 和 
ui32 Config 间 的 逻辑 或 操作 结果 来 配置 
返回 值 无 
表 I-6 TimerControlEvent 
功能 控制 事件 类 型 
void TimerControlEvent (uint32_t ui32 Base , 
函数 原型 uint32_t ui32 Timer , 
uint32_t ui32 Event ) 
ui32Base 定时 需 模 块 的 基地 址 
参数 ui32Timer ”指定 待 调整 的 定时 器 ， 它 必须 为 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
= ui32Event 指定 事件 的 类 型 ， 必 须 为 TIMER_EVENT_POS_EDGE 、TIMER_EVENT_NEG_ 
EDG 或 TIMER_EVENT_BOTH_EDGES 中 的 一 个 
描述 该 函数 设置 在 捕获 模式 中 触发 定时 器 的 信号 沿 
返回 值 无 
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表 1-7 TimerControlLevel 























































































































功能 控制 输出 电 平 
void TimerControlLevel (uint32_t ui32Base, 
函数 原型 uint32_t m32Timer , 
bool blnvert ) 
ui32Base 定时 需 模 块 的 基地 址 
参数 ui32Timer ”指定 待 调整 的 定时 器 ， 它 必须 为 TIMER_A 、TIMER_B 或 TIMER_BOTH 其 中 之 一 
bInvert ”指定 输出 电 平 
描述 该 函数 用 于 设置 指定 定时 器 的 PWM 输出 电 平 。 若 参数 bmvert 为 rue， 定 时 器 输出 低 电 
平 有 效 ; 否则 ， 定 时 需 输 出 为 高 电 平 
返回 值 无 
表 I-8 TimerControlStall 
功能 控制 停止 处 理 
void TimerControlStall (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Timer, 
bool bStall ) 
ui32Base 定时 需 模 块 的 基地 址 
参数 ui32Timer “指定 待 调整 的 定时 器 ， 必 须 是 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
bStall 指定 中 止 信号 的 响应 
描述 该 函数 控制 指定 的 定时 器 的 停止 响应 。 若 参数 pStall 为 bue， 定 时 器 在 处 理 器 进入 调试 
i 模式 时 将 停止 计数 ， 否则 ， 定 时 器 在 调试 模式 中 将 继续 运行 
返回 值 无 
表 I-9 TimerControlTrigger 
功能 使 能 或 禁止 ADC 触发 输出 
void TimerControlTrigger (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Timer , 
bool bEnable ) 
ui32Base 定时 需 模 块 的 基地 址 
参数 ui32Timer “指定 待 调整 的 定时 器 ， 必 须 是 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
bEnable 指定 ADC 所 需 的 触发 状态 
描述 该 函数 控制 指定 的 定时 器 的 ADC 触发 输出 。 若 参数 bEnable 为 rue， 使 能 定时 器 输出 触 
Ee 发 ; 否则， 禁止 定时 器 触发 输出 
返回 值 无 
表 I-10 TimerControlWaitOnTrigger 
功能 控制 触发 处 理 等 待 
void TimerControlWaitOnTrigger (uint32_t ui32Base , 
函数 原型 uint32_t ni32 Timer, 
bool bWait) 
ui32Base 定时 器 模 快 的 基地 址 
参数 ui32Timer ”指定 待 调整 的 定时 器 ， 必 须 是 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
bWait 指定 是 否 应 该 等 待定 时 器 触发 输入 
该 函数 控制 定时 器 在 开始 计数 时 是 否 需 等 待 一 个 触发 输入 。 使 能 时 ， 在 触发 链 之 前 的 定 
描述 时 器 必须 计数 到 超时 ， 以 便 这 个 定时 器 开始 计数 。 详 细 资 料 请 参照 技术 手册 中 有 关 触 发 器 
链 的 描述 
返回 值 无 
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表 1-11 TimerDisable 























































































































































































































































































































功能 禁止 定时 器 
る 本 電 void TimerDisable (uint32_t ui32Base， 
函数 原型 uint32_t ui32Timer) 
参数 ui32Base 定时 需 模 块 的 基地 址 
a ui32Timer ”指定 要 调整 的 定时 器 ， 且 必须 是 TIMER_A 、TIMER_B 或 TIMER_BOTH 其 中 之 一 
描述 该 函数 用 于 禁止 定时 器 模块 操作 
返回 值 无 
表 1-12 TimerDMAEventGe 
功能 返回 可 触发 DMA 请 求 的 事件 
函数 原型 uint32 t TimerDMAEventGet (uint32_t ui32Base) 
参数 u32Base ”定时 器 模块 的 基地 址 
该 函数 返回 定时 器 能 触发 DMA 序列 开始 的 事件 。 而 DMA 触发 事件 为 下 列 值 的 逻辑 或 . 
> TIMER_ADC_MODEMATCH_B // 使 能 定时 器 B 的 模式 匹配 DMA 触发 
> TIMER_ADC_CAPEVENT_B // 使 能 定时 器 B 的 捕获 事件 DMA 触发 
> TIMER_ADC_CAPMATCH_B // 使 能 定时 器 B 的 捕获 匹配 DMA 触发 
描述 > TIMER_ADC_TIMEOUT_B // 使 能 定时 器 B 的 超时 DMA 触发 
ES > TIMER_ADC_MODEMATCH_A // 使 能 定时 器 A 的 模式 匹配 DMA 触发 
> TIMER_ADC_RTC_A // 使 能 定时 器 A 的 RTC DAM 触发 
> TIMER_ADC_CAPEVENT_A // 使 能 定时 器 A 的 捕获 事件 DMA 触发 
> TIMER_ADC_CAPMATCH_A // 使 能 定时 器 A 的 捕获 匹配 DMA 触发 
> TIMER_ADC_TIMEOUT_A // 使 能 定时 器 A 的 超时 DMA 触发 
返回 值 定时 器 触发 uDMA 的 事件 
表 I-13 TimerDMAEventSet 
功能 禁止 定时 器 
函数 原型 void TimerDMAEventSet ( uint32_t ni32Base uint32_t ui32DMAEvent) 
参数 ui32Base 定时 需 模 块 的 基地 址 
站 ui32DMAEvent 可 触发 DMA 事件 的 位 屏蔽 
该 函数 使 能 定时 器 可 触发 DMA 序列 开始 的 事件 。 而 D MA 触发 事件 可 在 参数 
m32DMAEyent 中 指定 ， 该 值 可 从 下 列 值 的 迎 辑 或 运算 的 结果 中 得 到 : 
> TIMER_ADC_MODEMATCH_B // 已 使 能 定时 器 了 的 模式 匹配 ADC 触发 
> TIMER_ADC_CAPEVENT_B // 已 使 能 定时 器 B 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_B // 已 使 能 定时 器 B 的 捕获 匹配 ADC 触发 
描述 > TIMER_ADC_TIMEOUT_B // 已 使 能 定时 器 B 的 超时 ADC 触发 
> TIMER_ADC_MODEMATCH_A // 已 使 能 定时 器 A 的 模式 匹配 ADC 触发 
> TIMER_ADC_RTC_A // 已 使 能 定时 器 A 的 RTC ADC 触发 
> TIMER_ADC_CAPEVENT_A // 已 使 能 定时 器 A 的 捕获 事件 ADC 触发 
> TIMER_ADC_CAPMATCH_A // 已 使 能 定时 器 A 的 捕获 匹配 ADC 触发 
> TIMER_ADC_TIMEOUT_A // 已 使 能 定时 器 A 的 超时 ADC 触发 
返回 值 无 
表 I-14 TimerEnable 
功能 使 能 定时 器 
函数 原型 void TimerEnable (uint32_t ui32Base, uint32_t m32Timer ) 
参数 ui32Base 定时 需 模 块 的 基地 址 
ui32Timer 指定 待 调整 的 定时 器 ， 必 须 是 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
描述 该 函数 使 能 定时 器 模块 的 操作 ， 并 且 该 定时 器 必须 在 使 能 前 配置 
返回 值 


i 无 





表 1-15 TimerIntClear 





功能 清除 定时 器 的 中 断 源 
函数 原型 void TimerIntClear (uint32_t ui32Base, uint32_t ui32IntFlags) 





ui32Base ”定时 器 模块 的 基地 址 


参 妆 Nk ee 
参数 ui32IntFlags ” 待 清除 中 断 源 的 位 屏蔽 




















指定 待 清除 定时 器 的 中 断 源 ， 使 之 不 再 有 效 。 该 函数 必须 在 中 断 处 理 程序 中 调用 ， 以 免 
描述 在 退出 时 立即 再 次 对 其 触发 
参数 ui32IntFlags 和 TimerIntEnable( ) 中 的 参数 ui32 IntFlags 具有 相同 的 定义 


























返回 值 无 


表 I-16 TimerIntDisable 











功能 禁止 单个 定时 器 的 中 断 源 
函数 原型 void TimerIntDisable (uint32_t ui32Base, uint32_t ui32IntFlags ) 





u32Base ”定时 器 模块 的 基地 址 


































































































0 ui32IntFlags” 待 禁止 中 断 源 的 位 屏蔽 
描述 该 函数 禁止 指定 定时 器 的 中 断 源 
返回 值 无 
表 I-17 TimerIntEnable 
功能 使 能 单个 定时 器 的 中 断 源 
函数 原型 void TimerIntEnable (uint32_t ui32Base, uint32_t ui32IntFlags ) 
参数 ui32Base 定时 器 模块 的 基地 址 
= ui32IntFlags ” 待 使 能 中 断 源 的 位 屏蔽 
该 函数 使 能 指定 定时 器 的 中 断 源 
参数 ui32IntFlags 必须 为 以 下 任意 组 合 的 逻辑 或 : 
> TIMER_TIMB_DMA // 定 时 器 B DMA 完成 
> TIMER_TIMA_DMA // 定 时 器 A DMA 完成 
> TIMER_CAPB_EVENT // 捕 获 B 事件 中 断 
描述 > TIMER_CAPB_MATCH // 捕 获 B 匹 配 中 断 
> TIMER_TIMB_TIMEOUT ”// 定 时 器 B 超时 中 断 
> TIMER_RTC_MATCH //RTC 中 断 屏 蔽 
> TIMER_CAPA_EVENT // 捕 获 A 事件 中 断 
> TIMER_CAPA_MATCH // 捕 获 A 匹配 中 断 
> TIMER_TIMA_TIMEOUT /定时 器 A 超时 中 断 
返回 值 
表 I-18 TimerIntRegister 
功能 注册 定时 器 中 断 的 中 断 处 理 程序 
void TimerIntRegister ( uint32_t ui32Base, 
函数 原型 uint32_t m32Timer , 


void ( * pfnHandler) (void ) ) 





ui32Base 定时 需 模 块 的 基地 址 
参数 ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
pfnHandler 指向 发 生 定 时 器 中 断 时 被 调 函 数 的 指针 




































































该 函数 用 于 注册 在 发 生 定时 器 中 断 时 需 调用 的 处 理 程序 。 此 外 ,该 函数 可 使 能 中 断 控制 
描述 器 中 的 全 局 中 断 ， 特 定 定时 器 中 断 必 须 通 过 TimerIntEnable( ) 函数 使 能 ， 而 调用 TimerInt- 
Clear( ) 来 清除 中 断 源 是 中 断 处 理 程序 的 责任 
返回 值 无 
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表 1-19 TimerIntStatus 




































































































































































功能 获取 当前 的 中 断 状态 
ーー | uint32 t TimerIntStatus (uint32_t ui32Base, 
函数 原型 bool bMasked ) 
ui32Base 定时 器 模块 的 基地 址 
参 数 bMasked 若 要 求 原始 中 断 状 态 ，bMasked 取 false; 若 要 求 中 断 屏 蔽 状 态 ，bMasked 
取 true 
描述 该 函数 返回 定时 器 模 块 的 中 断 状 态 。 无 论 原始 中 断 状 态 ， 还 是 允许 反映 到 处 理 器 的 中 断 
汪汪 状态 都 会 被 返回 
返回 值 当前 的 中 断 状态 , 由 TimerlIntEnable( ) 来 枚 举 位 字段 的 值 
表 I-20 TimerIntUnregister 
功能 注销 定时 器 中 断 的 中 断 处 理 程序 
志 尖 四 刑 void TimerIntUnregister ( uint32_t ui32 Base , 
函数 原型 uint32_t ui32Timer) 
参数 ui32Base 定时 器 模块 的 基地 址 
ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
描述 该 函数 用 于 注销 在 发 生 定时 器 中 断 时 需 调 用 的 处 理 程序 。 这 个 函数 也 将 屏蔽 中 断 控制 器 
中 的 中 断 ， 以 便 中 断 处 理 程序 不 再 被 调用 
返回 值 无 
表 1-21 TimerLoadGet 
功能 获取 定时 器 的 装载 值 
| uint32_t TimerLoadGet (uint32_t ui32Base, 
函数 原型 uint32_t ui32Timer) 
ui32Base ”定时 器 模块 的 基地 址 
参数 ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A 或 TIMER_B 其 中 之 一 。 当 定时 器 被 配置 成 全 
宽 操 作 时 ， 只 有 TIMER_A 可 用 
描述 该 函数 用 于 获取 指定 定时 器 当前 可 编程 间隙 的 装载 值 
返回 值 返回 定时 器 的 装载 值 
表 I-22 TimerLoadGet64 
功能 获取 64 位 定时 器 的 装载 值 
函数 原型 uint64_t TimerLoadGet64 (uint32_t ui32 Base ) 
参数 u32Base ”定时 器 模块 的 基地 址 
描述 该 函数 用 于 获取 指定 64 位 定时 器 的 当前 可 编程 间隙 的 装载 值 
返回 值 返回 定时 器 的 装载 值 
表 1-23 TimerLoadSet 
功能 设置 定时 器 装载 值 
void TimerLoadSet (uint32_t ui32Base, 
函数 原型 uint32_t ni32 Timer , 





uint32_t ui32 Value ) 
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( 续 ) 


ui32Base ”定时 器 模块 的 基地 址 
ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A 、TIMER_B 或 TTMER_BOTH 其 中 之 一 。 当 定 



















































































































































































会 类 
时 器 配置 为 全 宽 操作 时 ， 只 有 TIMER_A 可 用 
ui32Value ”装载 值 
描述 该 函数 配置 定时 器 的 装载 值 ， 若 定时 器 正在 运行 ， 该 值 将 被 立即 加 载 到 定时 器 中 
返回 值 无 
表 I-24 TimerLoadSet64 
功能 设置 64 位 定时 器 的 装载 值 
a | void TimerLoadSet64 (uint32_t ui32Base, 
函数 原型 uint64_t ui64 Value ) 
参数 ui32Base ”定时 器 模块 的 基地 址 
ui64Value ”装载 值 
描述 该 函数 配置 64 位 定时 器 的 装载 值 ， 若 定时 器 正在 运行 ， 该 值 将 被 立即 加 载 到 定时 器 中 
返回 值 无 
表 I-25 TimerMatchGet 
功能 获取 定时 器 的 匹配 值 
店 電 | uint32_t TimerMatchGet (uint32_t m32 Base , 
函数 原型 uint32_t ui32Timer) 
ui32Base ”定时 器 模块 的 基地 址 
参数 ui32Timer ”指定 定时 器 ， 必 须 为 TIMER_A 、TIMER_B 其 中 之 一 。 当 定时 器 被 配置 成 全 
宽 操 作 时 ， 只 有 TIMER_A 可 用 
描述 该 函数 获取 指定 定时 器 的 匹配 值 
返回 值 返回 定时 器 的 匹配 值 
表 I-26 TimerMatchGet64 
功能 获取 64 位 定时 器 的 匹配 值 
函数 原型 uint64_t TimerMatchGet64 (uint32_t ui32Base) 
参数 u32Base 定时 器 模块 的 基地 址 
描述 该 函数 获取 指定 定时 器 的 匹配 值 
返回 值 返回 定时 器 的 匹配 值 
表 1-27 TimerMatchSet 
功能 设置 定时 器 的 匹配 值 
void TimerMatchSet (uint32_t ui32Base， 
函数 原型 uint32_t m32Timer , 
uint32_t ui32 Value ) 
u32Base ”定时 器 模块 的 基地 址 
参数 ui32Timer ”指定 定时 器 ， 必 须 为 TIMER_A 、TIMER_B 或 TIMER_BOTH 其 中 之 一 。 当 定 
用 时 器 配置 为 全 宽 操 作 时 ， 只 有 TIMER_A 可 用 
ui32 Value 匹配 值 
该 函数 配置 定时 器 的 匹配 值 。 该 值 用 于 在 捕获 计数 模式 中 决定 什么 时 候 中 断 处 理 器 ， 以 
描述 及 在 PWM 模式 中 用 它 来 确定 输出 信号 的 占 空 比 。 在 一 些 Tiva 器 件 中 ， 匹 配 中 断 也 可 以 在 
周期 和 单 触发 模式 中 生成 
返回 值 无 
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表 1-28 TimerMatchSet64 


















































































































































功能 设置 64 位 定时 器 的 匹配 值 
7 直井 void TimerMatchSet64 (uint32_t ui32Base , 
函数 原型 uint64_t ui64 Value ) 
参 数 u32Base ”定时 器 模块 的 基地 址 
ui64Value 匹配 值 
描述 该 函数 配置 定时 器 的 匹配 值 。 该 值 用 于 在 捕获 计数 模式 中 决定 什么 时 候 中 断 处 理 器 ， 以 
及 在 PWM 模式 中 用 它 来 确定 输出 信号 的 占 空 比 
返回 值 无 
表 I-29 TimerPrescaleGet 
功能 获取 定时 器 的 预 分 频 值 
着 直井 uint32 t TimerPrescaleGet ( uint32_t ui32 Base , 
函数 原型 uint32_t ui32Timer) 
参数 ui32Base ”定时 器 模块 的 基地 址 
ui32Timer ”指定 定时 器 ， 必 须 为 TIMER_A 、TIMER_B 其 中 之 一 
该 函数 获取 输入 时 钟 预 分 频 器 的 值 。 预 分 频 器 只 在 半 宽 的 模式 中 操作 ， 并 且 可 用 于 扩展 
描述 半 宽 定时 器 模式 的 范围 。 预 分 频 器 为 处 于 周期 和 单 次 模式 的 递减 计数 提供 了 最 低 有 效 位 ; 
而 对 于 其 他 所 有 模式 ， 预 分 频 器 却 提供 最 高 有 效 位 
返回 值 定时 器 预 分 频 器 的 值 
表 1-30 TimerPrescaleMatchGet 
功能 获取 定时 器 预 分 频 的 匹配 值 
| uint32_t TimerPrescaleMatchGet (uint32_t ui32Base, 
函数 原型 uint32_t ui32Timer) 
参数 ui32Base 定时 需 模 块 的 基地 址 
ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A 、TIMER_B 其 中 之 一 
描述 该 函数 获取 输入 时 钟 预 分 频 器 的 匹配 值 。 在 使 用 计数 器 匹配 和 预 分 频 器 的 半 宽 模式 中 ， 
预 分 频 匹 配 会 有 效 的 扩展 匹配 的 范围 
返回 值 定时 器 预 分 频 的 匹配 值 
表 1-31 TimerPrescaleMatchSet 
功能 设置 定时 器 预 分 频 的 匹配 值 
void TimerPrescaleMatchSet (uint32_t ui32Base， 
函数 原型 uint32_t ui32Timer , 
uint32_t ui32 Value ) 
ui32Base 定时 器 模块 的 基地 址 
参数 ui32Timer 指定 定時 器 , 必須 妨 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
四 ui32Value ”定时 器 预 分 频 匹 配 值 。 对 于 16/32 位 定时 器 ， 该 值 必须 在 0 ~ 255 之 间 (包括 
边界 ); 对 于 32/64 位 定时 器 ， 该 值 必须 在 0 ~65535 之 间 (包括 边界 ) 
描述 该 函数 配置 输入 时 钟 预 分 频 器 的 匹配 值 
返回 值 无 
表 1-32 TimerPrescaleSet 
功能 设置 定时 器 的 预 分 频 值 
void TimerPrescaleSet ( uint32_t ui32Base， 
函数 原型 uint32_t ui32Timer, 





uint32_t ui32 Value ) 
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2Base 定时 器 模块 的 基地 址 
































































































































> TIMER_4B_SYNC 

> TIMER_SA_SYNC 

ヶ TIMER_SB_SYNC 

> WTIMER_0A_SYNC 
> WTIMER_0B_SYNC 
ヶ WTIMER_1A_SYNC 
> WTIMER_1B_SYNC 
ヶ WTIMER_2A_SYNC 
> WTIMER_2B_SYNC 
> WTIMER_3A_SYNC 
> WTIMER_3B_SYNC 
> WTIMER_4A_SYNC 














参 数 u32Timer 指定 定时 器 ， 必 须 为 TIMER_A、TIMER_B 或 TIMER_BOTH 其 中 之 一 
u32Value ”定时 需 预 分 频 匹 配 值 
描述 该 函数 配置 输入 时 钟 预 分 频 器 的 值 
返回 值 无 
表 I-33 TimerRTCDisable 
功能 禁止 RTC 计数 
函数 原型 void TimerRTCDisable ( uint32_t ni32 Base ) 
参 数 u32Base 定时 器 模块 的 基地 址 
描述 该 函数 用 于 在 RTC 模式 中 停止 定时 器 计数 
返回 值 无 
表 I-34 TimerRTCEnable 
功能 使 能 RTC 计数 
函数 原型 void TimerRTCEnable ( uint32_t ui32Base ) 
参数 ui32Base ”定时 器 模 快 的 基地 址 
描述 该 函数 用 于 在 RTC 模式 中 使 定时 器 开始 计数 。 如 果 定 时 器 未 被 配置 成 RTC 模式 ， 则 该 
本 函数 无 效 
返回 值 无 
表 I-35 TimerSynchronize 
功能 一 组 定时 器 中 的 同步 计数 器 
到 沥 | 厨 弄 void TimerSynchronize (uint32_t ui32Base, 
函数 原型 uint32_t ui32Timers) 
参数 ui32Base ”定时 器 模块 的 基地 址 ， 该 参数 必须 为 Timer0 的 基 址 ( 即 TIMERO_BASE ) 
ui32Timer 设置 定时 顺 同 步 
该 函数 用 于 在 一 组 指定 定时 器 中 同步 计数 器 。 当 定时 器 在 半 宽 模式 中 运行 时 ， 每 一 半 可 
被 包括 或 排除 在 该 同步 事件 。 当 定时 器 运行 在 全 宽 模 式 中 ， 仅 定时 器 A 可 被 同步 (指定 的 
定时 器 B 没有 作用 ) 
参数 ui32Timers 可 以 是 下 列 定 义 的 任何 组 合 的 逻辑 或 : 
> TIMER_0A_SYNC 
> TIMER_0B_SYNC 
> TIMER_1A_SYN 
> TIMER_1B_SYNC 
> TIMER_2A_SYNC 
ヶ TIMER_2B_SYNC 
> TIMER_3A_SYNC 
> TIMER_3B_SYNC 
描述 > TIMER_4A_SYNC 
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> WTIMER_4B_SYNC 
描述 > WTIMER_5A_SYNC 
> WTIMER_5B_SYNC 








返回 值 无 

表 1-36 TimerValueGet 
功能 获取 当前 定时 器 的 值 
函数 原型 uint32_t TimerValueGet (uint32_t ui32Base， 


uint32_t ui32Timer) 





ui32Base “定时 器 模块 的 基地 址 
参数 ui32Timer 指定 定时 器 ， 必 须 为 TIMER_A、TIMER_B 其 中 之 一 。 当 定时 器 配置 成 全 宽 
的 操作 时 ， 只 能 使 用 TIMER_A 
































描述 该 函数 读 取 指定 定时 器 的 当前 值 
返 回 人 返回 定时 器 的 当前 值 








表 I-37 TimerValueGet64 

















功能 获取 64 位 定时 器 当前 值 

函数 原型 uint64 +t TimerValneGet64 (uint32_t ni32Base ) 
参 数 ui32Base ”定时 噩 模块 的 基地 址 

描述 该 函数 读 取 指定 定时 器 的 当前 值 

返回 值 返回 定时 器 的 当前 值 








附录 J 第 12 章 附 录 : PWM 固件 库 函 数 简 介 


本 章 附 录 将 介绍 Tiva C 系列 芯片 的 PWM API 库 函 数 。 
表 』-1 PWMClockGet 


レク 











功能 获取 当前 PWM 的 时 钟 配置 

函数 原型 uint32 t PWMClockGet (uint32_t mi32Base ) 
参 数 ui32Base PWM 模块 的 基地 址 

描述 该 函数 返回 当前 PWM 的 时 钟 配置 











返回 当前 PWM 的 时 钟 配置 ， 必 须 为 下 列 值 之 一 : 
> PWM_SYSCLK_DIV_1 

> PWM_SYSCLK_DIV_2 

> PWM_SYSCLK_DIV_4 

> PWM_SYSCLK_DIV_8 

> PWM_SYSCLK_DIV_16 

> PWM_SYSCLK_DIV_32 

> PWM_SYSCLK_DIV_64 


岗 
可 
W 
洋 








458 


表 J-2 PWMClockSet 































































































功能 设置 当前 PWM 的 时 钟 配置 
7 旬 void PWMClockSet (uint32_t 32 Base , 
函数 原型 uint32_t ui32Config) 
ui32Base PWM 模块 的 基地 址 
ui32Config PWM 的 时 钟 配置 ， 必 须 为 下 列 值 之 一 : 
> PWM_SYSCLK_DIV_1 
> PWM_SYSCLK_DIV_2 
参 数 > PWM_SYSCLK_DIV_4 
> PWM_SYSCLK_DIV_8 
> PWM_SYSCLK_DIV_16 
> PWM_SYSCLK_DIV_32 
> PWM_SYSCLK_DIV_64 
描述 该 函数 设置 PWM 的 时 钟 分 频 器 作为 PWM 时 钟 源 。 它 还 配置 PWM 模块 的 时 钟 频率 作为 系统 
时 钟 的 分 频 。 这 个 时 钟 用 于 PWM 模块 产生 PWM 信和 号 ; 它 的 速度 构成 所 有 PWM 信和 号 的 基础 
返回 参数 无 
表 J-3 PWMDeadBandDisable 
功能 禁止 PWM 死 区 输出 
る 本 人 void PWMDeadBandDisable (uint32_t um32 Base , 
函数 原型 uint32_t ui32Gen) 
ui32Base PWM 模块 的 基地 址 
ui32Gen ”修改 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 
参数 > PWM_GEN_0 
上 > PWM_GEN_1 
> PWM_GEN_2 
> PWM_GEN_3 
描述 该 函数 禁止 指定 PWM 发 生 器 的 死 区 模式 ， 可 将 OUTA 和 OUTB 信和 号 去 耦 
返回 参数 无 
表 J-4 PWMDeadBandEnable 
功能 使 能 PWM 死 区 输出 与 设置 死 区 延迟 
void PWMDeadBandEnable (uint32_t ui32Base, 
7 電 | uint32_t ui32Gen, 
函数 原型 uint16_t uil6Rise, 
uint16_t uil6Fall ) 
ui32Base PWM 模块 的 基地 址 
ui32Gen 修改 PWM 发 生 器 ， 必须 为 下 列 值 之 一 : 
> PWM_CEN_0 
参数 > PWM_CEN_1 
> PWM_CEN_2 
> PWM_GEN_3 
uil6Rise 指定 上 升 治 的 延迟 宽度 
uil6Fall 指定 下 降 沿 的 延迟 宽度 
描述 该 函数 设置 指定 PWM 发 生 器 的 死 区 ， 这 里 死 区 被 定义 为 从 PWM 发 生 器 OUTA 信号 的 上 
升 沿 或 下 降 沿 开始 的 PWM 时 钟 节拍 数 。 注 意 ， 这 个 函数 导致 OUTB 耦合 到 OUTA 
返回 参数 无 
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表 J-5 PWMFaultIntClear 






























































功能 清除 PWM 模块 的 故障 中 断 
函数 原型 void PWMFaultIntClear ( uint32_t ui32 Base ) 
参 数 ui32Base PWM 模块 的 基地 址 
该 函数 通过 在 所 选 PWM 模块 的 中 断 状态 寄存 器 中 写 入 相应 位 来 清除 故障 中 断 。 此 函数 
描述 仅 能 清除 FAULTO 中 断 并 保留 向 后 兼容 。 推 荐 采用 PWMFaultIntClearExt ( ) 替 代 PWM- 
NIS FaultintClear( ) 函数 ， 因 为 它 支持 设备 上 给 出 的 所 有 故障 中 断 ， 且 无 论 是 否 带 有 扩展 PWM 
故障 处 理 程序 均 能 得 到 支持 
返回 参数 无 
表 J-6 PWMEaultIntClearExt 
功能 清除 PWM 模块 的 故障 中 断 
ー と | void PWMFaultIntClearExt (uint32_t ui32Base, 
函数 原型 uint32_t ui32FaultInts ) 
参数 ui32Base PWM 模块 的 基地 址 
ui32FaultInts ”指定 待 清除 的 故障 中 断 
该 函数 通过 在 所 选 PWM 模块 的 PWM 中 断 状态 寄存 器 中 写 入 相应 位 来 清除 一 个 或 多 个 故 
障 中 断 
参数 ui32FaultInts 必须 为 下 列 值 的 逻辑 或 . 
> PWM_INT_FAULTO 
> PWM_INT_FAULT1 
描述 > PWM_INT_FAULT2 


> PWM_INT_FAULT3 

在 设备 上 运行 支持 扩展 PWM 故障 的 处 理 程序 时 ， 通 过 执行 给 定 生 成 器 每 个 所 配置 的 故 
障 触发 信号 的 逻辑 或 结果 来 驱动 故障 中 断 。 故 这 些 中 断 不 是 直接 与 设备 候选 的 4 个 
FAULTn 输入 关联 ， 但 这 表明 发 出 的 故障 信号 已 传达 到 了 4 个 候选 的 PWM 发 生 器 的 其 中 之 
一 。 对 于 没有 扩展 PWM 故障 处 理 程序 的 设备 ， 则 中 断 与 单一 故障 引 脚 的 状态 直接 关联 
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表 』-7 PWMFaultIntRegister 






























































功能 注册 PWM 模块 中 的 故障 状态 检测 的 处 理 处 理 程序 
函数 原型 void PWMFaultIntRegister ( uint32_t ui32 Base , void ( * pfnIntHandler) (void) ) 
参 数 u32Base PWM 模块 的 基地 址 
pfnIntHandler 指向 当 PWM 故障 中 断 发 生 时 被 调 函 数 的 指针 

当 检 测 到 所 选 PWM 模块 中 的 故障 中 断 时 ,该 函数 可 确保 由 pfnIntHandler 指定 的 中 断 处 
描述 理 程序 被 调用 。 该 函数 还 应 该 在 NVIC 中 使 能 PWM 故障 中 断 ， 以 及 必须 通过 PWMIntEna- 

ble ( ) 在 模块 级 使 能 PWM 故障 中 断 
返回 参数 无 
表 J-8 PWMEaultIntUnregister 
功能 注销 PWM 故障 状态 的 中 断 处 理 程序 
函数 原型 void PWMFaultlntUnregister (uint32_t 32 Base ) 
参数 ui32Base PWM 模块 的 基地 址 
描述 该 函数 从 所 选 PWM 模块 中 删除 PWM 政 障 中 断 的 中 断 处 理 程序 。 该 函数 还 应 该 在 NVIC 
a 中 使 能 PWM 故障 中 断 ， 以 及 必须 通过 PWMIntEnable ( ) 在 模块 级 使 能 PWM 故障 中 断 

返回 参数 无 
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功能 


表 J-9 PWMGenConfigure 
配置 PWM 秋生 器 





函数 原型 


void PWMGenConfigure (uint32_t ui32Base, 
uint32_t ui32 Gen, 
uint32_t ui32 Config) 





ui32Base PWM 模块 的 基地 址 
ui32Gen 修改 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 
> PWM_CEN_0 
> PWM_CEN_1 
> PWM_CEN_2 
> PWM_CEN_3 
ui32Config PWM 发 生 器 的 配置 

















该 函数 用 于 设置 PWM 发 生 器 操作 模式 。 可 配置 成 计数 模式 、 同 步 模 式 ， 以 及 调试 行为 。 
完成 配置 后 发 生 器 将 保持 禁止 状态 
PWM 发 生 器 具有 两 种 不 同 的 计数 模式 : 递减 计数 模式 或 先 递增 后 递减 计数 模式 。 在 
递减 计数 模式 时 ， 将 从 装载 值 递 减 计 数 到 零 ， 然 后 重 置 为 装载 值 ， 可 生成 左 对 齐 的 
PWM 信和 号。 在 先 递增 后 递减 计数 模式 下 ， 将 先 从 零 弟 递增 计数 到 转载 值 ， 然 后 递减 计数 
到 零 ， 然 后 重 [生成 中 心 对 齐 的 PWM 信号 。 若 修 政 PWM 发 生 器 的 参数 ( 周 
期 和 脉冲 宽度 ) ， 其 对 PWM 信和 号 输出 的 影响 可 被 延迟 。 在 同步 模式 下 ， 只 有 发 生 同 步 事 
件 后 才 可 进行 人 这 种 模式 允许 对 多 个 参数 进行 修改 并 同时 生效 ， 而 不 是 一 次 一 
个 。 此 外 ， 在 同步 模式 下 ， 多 个 PWM 发 生 器 参数 可 以 同时 更 新 ， 允 许 其 被 当 作 一 个 统 
一 发 生 器 来 处 理 。 在 非 同步 模式 中 ， 参 数 的 更 新 不 会 延 时 到 同步 事件 的 发 生 。 在 两 种 模 
式 下 ， 仅 在 计数 器 的 值 为 零 时 ， 才 会 发 生 参 数 更 新 ， 以 防止 在 参数 更 新 过 程 中 形成 奇异 
的 PWM 信号 
在 处 理 器 因 调 试 器 停止 时 ， 此 时 ，PWM 发 生 器 既 可 以 暂停 ,也 可 继续 运行 。 如 果 配 置 
成 暂停 ， 它 将 继续 计数 直到 零 为 止 ， 在 该 点 发 生 器 将 被 暂停 ， 直 到 处 理 器 重新 启动 。 如 果 
配置 成 连续 运行 ，PWM 发 生 器 将 会 一 直 计 数 
参数 ui32Config 包含 所 需 的 配置 ， 为 以 下 值 的 逻辑 或 : 
> PWM_CEN_MODE_DOWN 或 PWM_GEN_MODE_UP_DOWN// 指 定 计 数 模 式 
> PWM_GEN_MODE_SYNC 或 PWM_GEN_MODE_NO_SYNC// 指 定 计数 器 的 装载 值 和 比 
> PWM_GEN_MODE_DBG_RUN 或 PWM_GEN_MODE_DBG_STOP// 指 定 调试 的 行为 
> PWM_GEN_MODE_GEN_NO_SYNC 、PWM_GEN_MODE_GEN_SYNC_LOCAL 或 PWM_ 
GEN_MODE_GEN_SYNC_GLOBAL// 指 定 发 生 器 计数 模式 的 变化 同步 更 新 模式 
> PWM_CEN_MODE_DB_NO_SYNC、PWM_CEN_MODE_DB_SYNC_LOCAL 或 PWM_GEN 
_MODE_DB_SYNC_GLOBAL// 指 定 死 区 参 数 的 同 歩 模式 
> PWM_CEN_MODE_FAULT_LATCHED 或 PWM_CEN_MODE_FAULT_UNLATCHED// 指 
定 是 否 锁定 或 故障 状态 
> PWM_GEN_MODE_FAULT_MINPER 或 PWM_CEN_MODE_FAULT_NO_MINPER// 指 定 
是 否 需 要 最 小 故障 周期 支 : 
> PWM_GEN_MODE_FAULT_EXT 或 PWM_GEN_MODE_FAULT_LEGACY// 指 定 是 否 使 
能 扩展 故障 源 选择 支持 
设置 PWM_GEN_MODE_FAULT_MINPER 允许 应 用 程序 设置 PWM 故障 信号 的 最 小 持续 
时 间 。 即 使 外 部 故障 引 脚 已 经 取消 了 故障 状态 ， 故 障 信号 也 至 少 会 产生 一 次 。 使 用 这 种 模 
式 时 应 该 小 心 ， 因 为 PWM 产生 的 故障 中 断 是 一 直 有 效 的。 因此 ， 如 果 中 断 处 理 函 数 的 退 
出 早 于 故障 定时 器 所 规定 的 时 间 ， 有 可 能 会 立即 再 次 触发 中 断 处 理 程 序 










































































































































































条 
























































a 
本 
NN 
尿 





功能 





无 


表 J-10 PWMGenDisable 


能 禁止 PWM 发 生 需 模块 的 定时 器 /计数 天 





函数 原型 





void PWMGenDisable (uint32_t ui32Base, 
uint32_t ui32Cen ) 
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ui32Base PWM 模块 的 基地 址 

ui32Gen 禁止 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 
> PWM_GEN_0 

> PWM_GEN_1 

> PWM_GEN_2 

> PWM_GEN_3 
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该 函数 封锁 PWM 时 钟 驱 动 指定 发 生 融 模 块 的 定时 器 /计数 需 
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无 





表 』-11 PWMGenEnable 
功能 使 能 PWM 发 生 器 模块 的 定时 器 /计数 器 








void PWMGenEnable (uint32_t ui32Base, 


函数 原型 
函数 原型 uint32_t ui32Gen) 





ui32Base PWM 模块 的 基地 址 

ui32Gen 禁止 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 ; 
> PWM_GEN_0 

> PWM_GCEN_1 

> PWM_GEN_2 

> PWM_GEN_3 








描述 该 函数 允许 PWM 时 钟 驱 动 指定 的 发 生 器 的 定时 器 /计数 器 
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表 J-12 PWMGenEaultClear 
功能 清除 给 定 PWM 发 生 器 的 一 个 或 多 个 锁 存 故障 触发 








void PWMGenFaultClear (uint32_t ui32Base, 
uint32_t ui32Gen, 







































































Ei 洲 | 
函数 原型 uint32_t m32Group , 
uint32_t ui32FaultTriggers ) 
ui32Base PWM 模块 的 基地 址 
u32Gen 正在 查询 的 PWM 发 生 器 故障 触发 状态 ， 必 须 为 下 列 值 之 一 : 
> PWM_CEN_0 
> PWM_CEN_1 
参数 > PWM_GEN_2 
> PWM_GEN_3 
ui32Group ”指示 被 查询 故障 的 子 集 ， 该 参数 必须 为 PWM_FAULT_GROUP_0 或 PWM_ 
FAULT_GROUP_1 
u32FaultTriggers ”被 清除 的 故障 触发 器 集 
描述 该 函数 允许 应 用 程序 清除 给 定 PWM 发 生 器 的 故障 触发 。 只 有 之 前 用 参数 ui32Config 中 
的 标志 PWM_GEN_MODE_FAULT_LATCHED 调用 PWMGenConfigure ( ) ， 才 需要 用 该 函数 





























返回 参数 无 





表 J-13 PWMGenEaultConfigure 
功能 配置 指定 PWM 发 生 器 的 最 小 故障 周期 与 故障 引 脚 意义 (sense) 








void PWMCenFaultConfigure (uint32_t ui32Base， 
uint32_t ui32Cen ， 
uint32_t ui32MinFaultPeriod , 
uint32_t ui32FaultSenses ) 


函数 原型 
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ui32Base PWM 模块 的 基地 址 

ui32Gen PWM 发 生 器 的 故障 配置 设置 ， 必 须 为 下 列 值 之 一 : 

> PWM_CEN_0 

> PWM_CEN_1 

> PWM_CEN_2 

> PWM_CEN_3 

ui32MinFaultPeriod ”表示 在 PWM 时 钟 周期 中 的 最 小 故障 激活 周期 

ui32FaultSenses ”指示 故障 输入 的 何 种 状态 为 有 效 。 有 效 值 为 PWM_FAULTn_SENSE_ 
HIGH 与 PWM_FAULTn_SENSE_LOW 的 逻辑 或 








该 函数 配置 给 定 发 生 器 的 最 小 故障 周期 与 4 个 候选 的 故障 输入 中 各 自 的 意义 (sense) 。 
以 PWM 时 钟 周 期 表示 最 小 故障 周期 ， 仅 当 用 设置 在 参数 ui32Config 中 的 标志 PWM_GEN_ 
MODE_FAULT_PER 来 调用 PWMGenConfigure( ) 函数 时 ， 它 才 会 生效 。 当 故障 输入 有 效 时 ， 
最 小 故障 周期 定时 器 确保 其 至 少 在 指定 的 时 钟 周期 数 内 仍然 有 效 
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功能 


无 


表 J』-14 PWMGenFaultStatus 
返回 给 定 PWM 发 生 器 的 当前 故障 触发 状态 











函数 原型 


uint32 t PWMGenFaultStatus (uint32_t ui32Base, 
uint32_t ui32Cen , 
uint32_t ui32Group ) 
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ui32Base PWM 模块 的 基地 址 

u32Gen 正在 查询 故障 触发 状态 的 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 

> PWM_CEN_0 

> PWM_GEN_1 

> PWM_GEN_2 

> PWM_GEN_3 

ui32Group ”指示 被 查询 故障 的 子 旨 
GROUP_1 








该 参数 必须 为 PWM_FAULT_GROUP 0 或 PWM_FAULT 


Mr 




















该 函数 允许 应 用 程序 查询 给 定 PWM 发 生 器 每 个 故障 触发 器 输入 的 当前 状态 。 返 回 每 个 
故障 触发 输入 的 当前 状态 ， 除 非 使 用 参数 ui32Config 中 的 标志 PWM_GEN_MODE_FAULT_ 
LATCHEDP 先期 调用 PWMGenConfigure ( ) 函数 ， 在 这 种 情况 下 ， 返 回 的 状态 为 锁 存 故障 触 
发 的 状态 

如 果 配 置 成 锁 存 故障 ， 应 用 程序 必须 调用 PWMCenFaultClear( ) 来 清除 每 个 触发 
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返回 给 定 的 PWM 发 生 器 故障 触发 的 当前 状态 。 置 位 表示 相关 的 触发 被 激活 的 
对 于 PWM_FAULT_GROUP 0， 返回 值 为 下 列 值 的 逻辑 或 ， 
> PWM_FAULT_FAULTO 

> PWM_FAULT_ FAULT1 

> PWM_FAULT_ FAULT2 

> PWM_FAULT_ FAULT3 

对 于 PWM_FAULT_GROUP_1， 返 回 值 为 下 列 值 的 逻辑 或 : 
> PWM_FAULT_DCMPO 

> PWM_FAULT_DCMP1 

> PWM_FAULT DCMP2 

> PWM_FAULT_DCMP3 

> PWM_FAULT DCMP4 

> PWM_FAULT_DCMPS 

> PWM_FAULT_DCMP6 

> PWM_FAULT_DCMP7 
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表 』-15 PWMGenFaultTriggerGet 
功能 返回 给 定 PWM 发 生 器 当前 配置 的 故障 触发 设置 











unt32 t PWMGenFaultTriggerGet (uint32_t ui32 Base , 
函数 原型 uint32_t ui32 Cen , 
uint32_t ui32 Group ) 





ui32Base PWM 模块 的 基地 址 
ui32Gen 正在 查询 故障 触发 的 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 


> PWM_CEN_0 
参数 > PWM_GEN_1 
> PWM_GEN_2 
> PWM_GEN_3 


ui32Group ”指示 被 查询 故障 的 子 集 。 这 个 参数 必须 为 PWM_FAULT_GROUP_0 或 PWM_ 
FAULT_GROUP_1 

















描述 该 函数 允许 应 用 程序 查询 当前 的 输入 设置 ， 这 有 助 于 产生 给 定 的 PWM 发 生 器 的 故障 状态 























返回 所 提供 故障 组 的 当前 故障 触发 配置 

对 于 PWM_FAULT_GROUP 0， 返回 值 为 下 列 值 的 逻辑 或 ， 
> PWM_FAULT_ FAULTO 

> PWM_FAULT_ FAULT1 

> PWM_FAULT_ FAULT2 

> PWM_FAULT_ FAULT3 

对 于 PWM_FAULT_GROUP_1， 返 回 值 为 下 列 值 的 逻辑 或 : 
> PWM_FAULT_DCMPO 

> PWM_FAULT_ DCMP1 

> PWM_FAULT_DCMP2 

> PWM_FAULT_DCMP3 

> PWM_FAULT DCMP4 

> PWM_FAULT_DCMPS 

> PWM_FAULT_DCMP6 

> PWM_FAULT_DCMP7 


互 
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表 』-16 PWMGenFaultTriggerSet 
功能 配置 给 定 PWM 发 生 器 故障 触发 的 设置 








void PWMGenFaultTriggerSet (uint32_t ui32Base, 
uint32_t ui32Gen, 
uint32_t ui32Group, 
uint32_t ui32FaultTriggers ) 


函数 原型 





ui32Base PWM 模块 的 基地 址 

ui32Gen PWM 发 生 器 的 故障 触发 设置 ， 必 须 为 下 列 值 之 一 . 

> PWM_GEN 0 

> PWM_CEN_1 

> PWM_GEN_2 

> PWM_GEN 3 

ui32Group ”指示 被 可 能 的 故障 子 集 的 配置 ， 这 个 参数 必须 为 PWM_FAULT_GROUP_0 或 
PWM_FAULT_CROUP_1 

u32FaultTriggers ”定义 输入 的 设置 有 助 于 产生 给 定 PWM 发 生 器 的 故障 信和 号 

对 于 PWM_FAULT_GROUP 0， 返回 值 为 下 列 值 的 逻辑 或 : 

> PWM_FAULT_ FAULTO 

> PWM_FAULT_ FAULT1 

> PWM_FAULT_ FAULT2 

> PWM_FAULT_ FAULT3 

对 于 PWM_FAULT_GROUP_1， 返 回 值 为 下 列 值 的 逻辑 或 : 

> PWM_FAULT_DCMPO 

> PWM_FAULT_ DCMP1 

> PWM_FAULT DCMP2 

> PWM_FAULT_DCMP3 

> PWM_FAULT_DCMP4 
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> PWM_FAULT_DCMPS 
描述 > PWM_FAULT_DCMP6 
> PWM_FAULT_DCMP7 





对 于 给 定 的 PWM 发 生 器 ， 该 函数 允许 选择 故障 输入 ， 并 结合 这 些 故障 输入 来 产生 故障 
状态 。 上 默认 情况 下 ， 所 有 发 生 器 只 使 用 FAULTO (向 后 兼容 性 ) ， 若 用 参数 u32Config 中 的 
PWM_CEN_MODE_FAULT_SRC 标志 来 调用 PWMGenConfigure( ) 函数 ， 将 使 能 扩展 故障 处 
描述 理 ， 以 及 必须 调用 该 函数 来 配置 故障 触发 
在 调用 PWMGenFaultConfigure( ) 配置 先前 设置 的 基础 上 ， 完 成 调整 每 个 FAULTn 输入 的 
意义 (sense) 后 ， 再 对 参数 ui32FaultTriggers 指定 的 所 有 信和 号 一 并 进行 “或 运算 ”， 即 可 
产生 PWM 发 生 器 的 故障 信和 号 







































































起 
























































返回 参数 无 
表 J-17 PWMGenIntClear 
功能 清除 指定 PWM 发 生 器 模块 的 指定 中 断 








void PWMCenIntClear (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Cen , 
uint32_t ui32 Tnts ) 





ui32Base PWM 模块 的 基地 址 

ui32Gen PWM 发 生 需 查询 ， 必 须 为 下 列 值 之 一 : 
> PWM_GEN_0 

> PWM_CEN_1 

> PWM_GEN_2 

> PWM_GEN_3 

ui32Ints 指定 待 清 除 的 中 断 
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该 函数 通过 向 中 断 状 态 寄存 器 中 特定 的 位 写 1 来 清除 指定 PWM 发 生 器 中 的 指定 中 断 
参数 ui32Ints 为 下 列 值 的 逻辑 或 

> PWM_INT_CNT_ZERO 

> PWM_INT_CNT_LOAD 

> PWM_INT_CNT_AU 

> PWM_INT_CNT_AD 

> PWM_INT_CNT_BU 

> PWM_INT_CNT_BD 
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无 


表 J-18 PWMGenIntRegister 
功能 注册 指定 PWM 发 生 器 模块 的 中 断 处 理 程序 











void PWMGenIntRegister (uint32_t ui32Base, 
函数 原型 uint32_t ui32Cen , 
void ( * pfnIntHandler) (void) ) 





ui32Base PWM 模块 的 基地 址 
ui32Gen 讨论 的 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 


> PWM_CEN_0 
参 数 > PWM_CEN_1 
> PWM_GEN_2 
> PWM_CEN_3 


pfnIntHandler 当 PWM 发 生 咒 中 断 发 生 时 指向 被 调 函 数 的 指针 




















当 检 测 到 指定 PWM 发 生 器 模块 的 一 个 中 断 时 ， 该 函数 可 确保 调用 由 pfnIntHandler 指定 
描述 的 中 断 处 理 程序 。 该 函数 也 使 能 中 断 控 制 器 中 相应 的 PWM 发 生 器 中 断 ; 各 个 发 生 器 中 断 
与 中 断 源 必须 调用 PWMIntEnable( ) 和 PWMGenIntTrigEnable( ) 函数 来 使 能 















































返回 参数 无 
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表 』-19 PWMGenIntStatus 








































































































功能 获取 指定 PWM 发 生 器 模块 的 中 断 状态 

uint32 t PWMGenIntStatus (uint32_t ui32Base , 
函数 原型 uint32_t ui32Gen, 

bool bMasked ) 

ui32Base PWM 模块 的 基地 址 

ui32Gen PWM 发 生 器 查询 ， 必 须 为 下 列 值 之 一 : 

> PWM_CEN_0 
参数 > PWM_CEN_1 

> PWM_CEN_2 

> PWM_GEN_3 

bMasked ”指定 返回 屏蔽 还 是 原始 中 断 状态 
描述 如 果 将 bMasked 设置 为 tue， 则 返回 屏蔽 中 断 状态 ; 否则 ， 将 返回 原始 中 断 状态 
返回 参数 返回 指定 PWM 发 生 器 的 中 断 状态 寄存 器 的 内 容 或 原始 中 断 状态 寄存 器 的 内 容 

表 J-20 PWMGenIntTrigDisable 

功能 禁止 指定 PWM 发 生 器 模块 的 中 断 

void PWMGenIntTrigDisable (uint32_t ui32Base, 
函数 原型 uint32_t ui32Cen , 

unt32_t ui32IntTrig ) 

ui32Base PWM 模块 的 基地 址 

ui32Gen 禁止 PWM 发 生 器 中 断 和 触发 ， 必 须 为 下 列 值 之 一 : 

> PWM_CEN_0 
参数 > PWM_CEN_1 

> PWM_GEN_2 

> PWM_GEN_3 

ui32IntTrig 指定 待 禁止 的 中 断 和 触发 

该 函数 通过 清除 指定 PWM 发 生 器 的 中 断 /触发 使 能 寄存 器 中 的 特定 位 来 屏蔽 指定 的 中 断 

和 触发 

参数 ui32IntTrig 为 下 列 值 的 逻辑 或 ， 

> PWM_INT_CNT_ZERO 

> PWM_INT_CNT_LOAD 

> PWM_INT_CNT_AU 

> PWM_INT_CNT_AD 
描述 > PWM_INT_CNT_BU 

> PWM_INT_CNT_BD 

> PWM_TR_CNT_ZERO 

> PWM_TR_CNT_LOAD 

> PWM_TR_CNT_AU 

> PWM_TR_CNT_AD 

> PWM_TR_CNT_BU 

> PWM_TR_CNT_BD 
返 回 参 数 无 

表 J-21 PWMGenIntTrigEnable 

功能 使 能 指定 PWM 发 生 器 模块 的 中 断 和 触发 

void PWMGenIntTrigEnable (uint32_t ui32 Base , 
函数 原型 uint32_t ui32 Gen , 





uint32_t ui32 IntTrig ) 
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ui32Base PWM 模块 的 基地 址 

ui32Gen 使 能 PWM 发 生 器 中 断 和 和 触发， 必须 为 下 列 值 之 一 : 
> PWM_CEN_0 

> PWM_GEN_1 

> PWM_CGEN_2 

> PWM_GEN_3 

ui32IntTrig 指定 待 使 能 的 中 断 和 触发 























该 函数 通过 置 位 指定 PWM 发 生 器 的 中 断 /触发 使 能 寄存 器 中 的 特定 位 来 取消 屏蔽 指定 的 
中 断 和 触发 

参数 ui32IntTrig 为 下 列 值 的 逻辑 或 ， 

> PWM_INT_CNT_ZERO 

> PWM_INT_CNT_LOAD 

> PWM_INT_CNT_AU 

> PWM_INT_CNT_AD 

> PWM_INT_CNT_BU 

> PWM_INT_CNT_BD 

> PWM_TR_CNT_ZERO 

> PWM_TR_CNT_LOAD 

> PWM_TR_CNT_AU 

> PWM_TR_CNT_AD 

> PWM_TR_CNT_BU 

> PWM_TR_CNT_BD 
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功能 





无 


表 J-22 PWMGenIntUnregister 
移 除 指定 PWM 发 生 器 模块 的 中 断 处 理 程序 











函数 原型 


void PWMGenIntUnregister (uint32_t ui32 Base , 
uint32_t ui32Gen) 
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ui32Base PWM 模块 的 基地 址 

ui32Gen 讨论 的 PWM 发 生 器 ， 必 须 为 下 列 值 之 一 : 
> PWM_GEN_0 

> PWM_GEN_1 

> PWM_GEN_2 

> PWM_GEN_3 











该 函数 用 于 注销 指定 PWM 发 生 器 模块 的 中 断 处 理 程序 。 这 个 函数 也 禁止 在 中 断 控制 器 
中 相应 的 PWM 发 生 器 中 断 ; 各 个 发 生 器 中 断 和 中 断 源 必须 调用 PWMIntDisable( ) 和 PWM- 
GenIntTrigDisable( ) 函数 来 禁止 














无 


表 J-23 PWMGenPeriodGet 
获取 PWM 发 生 器 模块 的 周期 





uint32_t PWMGenPeriodGet (uint32_t ui32Base, 
uint32_t ui32Gen) 








ui32Base PWM 模块 的 基地 址 

ui32Gen PWM 发 生 器 查询 ， 必 须 为 下 列 值 之 一 : 
> PWM_GEN_0 

> PWM_GEN_1 

> PWM_GEN_2 

> PWM_GEN_3 
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( 续 ) 





该 函数 获取 指定 PWM 发 生 器 模块 的 周期 。 发 生 器 模块 的 周期 被 定义 为 发 生 器 模块 中 0 
言 号 脉冲 之 间 的 PWM 时 钟 节拍 数 
































描述 如 果 指定 PWM 发 生 器 的 计数 器 更 新 还 未 完成 ， 返 回 值 可 能 不 是 现行 的 周期 ， 而 是 用 
PWM 时 钟 节拍 测量 的 编程 的 周期 
返回 参数 返回 PWM 时 钟 节拍 中 指定 发 生 器 模块 的 可 编程 周期 





表 J-24 PWMGenPeriodSet 



















































































功能 设置 PWM 发 生 器 的 周期 
void PWMGenPeriodSet (uint32_t ui32Base， 
函数 原型 uint32_t ui32Cen , 
uint32_t ui32Period ) 
ui32Base PWM 模块 的 基地 址 
ui32Gen PWM 发 生 器 查询 ， 必 须 为 下 列 值 之 一 : 
> PWM_CEN_0 
参数 > PWM_GEN_1 
> PWM_GEN_2 
> PWM_GEN_3 
ui32Period 指定 PWM 发 生 器 用 时 钟 节 拍 测量 的 输出 周期 
描述 该 函数 设置 指定 PWM 发 生 需 模块 的 周期 ， 其 中 发 生 器 模块 的 周期 被 定义 为 发 生 需 模块 
中 0 信号 脉冲 之 间 的 PWM 时 钟 节拍 数 
返回 参数 无 
表 J-25 PWMIntDisable 
功能 禁止 PWM 模块 的 发 生 器 中 断 和 故障 中 断 
| void PWMIntDisable (uint32_t m32Base , 
函数 原型 uint32_t ui32GenFault) 
ui32Base PWM 模块 的 基地 址 
ui32GenFault 包含 要 禁止 的 中 断 ， 参 数 必须 为 下 列 值 的 逻辑 或 : 
> PWM_CEN_0 
> PWM_GEN_1 
参数 > PWM_CEN_2 
> PWM_GEN 3 
> PWM_INT_FAULTO 
> PWM_INT_FAULTI1 
> PWM_INT_FAULT2 
> PWM_INT_FAULT3 
描述 该 函数 通过 清除 所 选 PWM 模块 的 中 断 使 能 寄存 器 中 特定 的 位 来 屏蔽 指定 的 中 断 
返回 参数 无 
表 』-26 PWMIntEnable 
功能 使 能 PWM 模块 的 发 生 器 中 断 和 故障 中 断 
7 古 刑 void PWMIntEnable (uint32_t ui32Base, 
函数 原型 uint32_t ui32 CenFault) 
ui32Base PWM 模块 的 基地 址 
u32GenFault 包含 待 使 能 的 中 断 ， 人 参数 必须 为 下 列 值 的 逻辑 或 : 
> PWM_CGEN_0 
参 数 > PWM_CEN_1 
> PWM_GEN_2 
> PWM_GEN_3 





> PWM_INT_FAULTO 
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> PWM_INT_FAULT1 












































































































































参 数 > PWM_INT_FAULT2 
> PWM_INT_FAULT3 
描述 该 函数 通过 置 位 所 选 PWM 模块 的 中 断 使 能 寄存 器 中 特定 的 位 来 取消 屏蔽 指定 的 中 断 
返回 参数 无 
表 J-27 PWMIntStatus 
功能 获取 指定 PWM 模块 的 中 断 状态 
| uint32_t PWMIntStatus (uint32_t ui32Base， 
函数 原型 bool bMasked ) 
参数 ui32Base PWM 模块 的 基地 址 
= bMasked 指定 返回 屏蔽 还 是 原始 中 断 状态 
描述 如 果 将 bMasked 设置 为 rue， 则 返回 屏蔽 中 断 状态 ; 和 否则， 将 返回 原始 中 断 状态 
返回 当前 的 中 断 状 态 ， 且 枚 举 为 下 列 的 位 字段 形式 : 
> PWM_CEN_0 
> PWM_CEN_1 
> PWM_CEN_2 
返回 参数 > PWM_CEN_3 
> PWM_INT_FAULTO 
> PWM_INT_FAULT1 
> PWM_INT_FAULT2 
> PWM_INT_FAULT3 
表 J-28 PWMOutputFault 
功能 指定 PWM 输出 的 状态 来 响应 故障 状态 
void PWMOutputFault (uint32_t ui32Base, 
函数 原型 uint32_t ui32PWMOutBits, 
bool bFaultSuppress ) 
ui32Base PWM 模块 的 基地 址 
um32PWMOutBits 待 修 政 的 PWM 输出 ， 为 下 列 值 的 逻辑 或 : 
> PWM_OUT_0_BIT 
> PWM_OUT_1_BIT 
> PWM_OUT_2_BIT 
参数 > PWM_OUT_3_BIT 
> PWM_OUT_4_BIT 
> PWM_OUT_S_BIT 
> PWM_OUT_6_BIT 
> PWM_OUT_7_BIT 
bFaultSuppress ”确定 在 一 个 激活 的 故障 状态 期 间 信号 是 被 抑制 还 是 通过 
该 函数 用 于 设置 所 选 PWM 输出 的 故障 处 理 特 性 。 使 用 参数 ui32PWMOutBits 来 选择 
输出 。 人 参数 bFaultSuppress 决定 所 选 输出 的 故障 处 理 特性 。 如 果 将 bFaultSuppress 设置 
为 true， 则 所 选 输出 无 效 。 若 bfaultsuppress 为 false ， 则 选 定 的 输出 不 受 检测 到 故障 的 
描述 影响 
在 支持 扩展 PWM 故障 处 理 的 设备 上 ， 受 影响 的 输出 引 脚 的 驱动 状态 ， 可 由 PWMOutput- 
FaultLevel( ) 函数 来 配置 。 如 果 不 配 置 ， 或 者 如 果 设备 不 支持 扩展 PWM 故障 处 理 ， 则 在 故 
障 状态 中 受 影响 的 输出 引 脚 将 被 驱动 为 低 电 平 
返回 参数 无 
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表 J-29 PWMOutputFaultLevel 
指定 被 抑制 的 PWM 输出 电 平 来 响应 一 个 故障 状态 





函数 原型 


void PWMOutputFaultLevel (uint32_t ui32Base, 
uint32_t u32PWMOutBits , 
bool bDriveHigh ) 





ui32Base PWM 模块 的 基地 址 

ui32PWMOutBits 待 修 政 的 PWM 输出 ， 为 下 列 值 的 逻辑 或 : 
> PWM_OUT_0_BTT 

> PWM_OUT_1_BTT 

> PWM_OUT_2_BTT 

> PWM_OUT 3_BIT 

> PWM_OUT 4_BIT 

> PWM_OUT 5_BIT 

> PWM_OUT_6_BTT 

> PWM_OUT 7_BIT 

bDriveHigh ”确定 在 一 个 激活 的 故障 状态 期 间 信号 是 被 拉 高 还 是 拉 低 














以 








该 函数 决定 被 抑制 的 PWM 输出 引 脚 在 响应 故障 状态 时 是 被 驱动 为 高 电 平 还 是 低 电 了 
使 用 参数 ui32PWMOutBits 来 选择 受 影响 的 输出 。 参 数 bDriveHigh 决定 由 ui32PWMOutBits 
辨识 的 引 脚 输出 电 平 。 如 果 将 bDriveHigh 设置 为 rue， 则 当 检测 到 一 个 故障 时 所 选 的 输出 
将 被 驱动 为 高 E 若 bDriveHigh 为 false， 则 引 脚 被 驱动 为 低 电 平 
在 故障 状态 下 ， 通 过 调用 PWMOutputFault ) 未 将 其 配置 成 抑制 的 引 脚 ， 将 不 受 这 个 函数 影响 
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功能 


无 


表 J』-30 PWMOutputInvert 
选择 PWM 输出 的 反 相 模式 





函数 原型 


void PWMOutputInvert (uint32_t ui32Base， 
uint32_t ui32PWMOutBits , 
bool blnvert ) 





ui32Base PWM 模块 的 基地 址 
ui32PWMOutBits ” 待 修 改 的 PWM 输出 ， 为 下 列 值 的 逻辑 或 : 
> PWM_OUT_0_BIT 

> PWM_OUT_1_BIT 

> PWM_OUT_2_BIT 

> PWM_OUT_3_BIT 

> PWM_OUT_4_BIT 

> PWM_OUT_S_BIT 

> PWM_OUT_6_BIT 

> PWM_OUT_7_BIT 

bInvert 确定 信号 是 被 反 相 还 是 通过 




















该 函数 用 于 为 选 定 的 PWM 输出 选择 反 相 模式 。 使 用 参数 ui32PWMOutBits 选择 输出 ， 而 参 
数 bInvert 用 于 确定 所 选 输出 的 反 相 模式 。 如 果 将 bInvert 设置 为 bue， 则 指定 的 PWM 输出 信 
号 将 反 相 或 使 低 电 平 有 效 。 若 bInvert 为 false， 则 指定 的 输出 信号 将 通过 或 使 高 电 平 有 效 





























功能 





无 


表 J-31 PWMOutputState 





使 能 或 禁止 PWM 输出 





函数 原型 





void PWMOutputState (uint32_t ui32Base, 
uint32_t m32PWMOutBits , 
bool bEnable ) 
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ui32Base PWM 模块 的 基地 址 

ui32PWMOutBits ” 待 修改 的 PWM 输出 ， 为 下 列 值 的 逻辑 或 : 
> PWM_OUT 0_BIT 

> PWM_OUT_1_BIT 

> PWM_OUT 2_BIT 






































































































































参数 > PWM_OUT 3_BIT 
> PWM_OUT_4_BIT 
> PWM_OUT_5_BIT 
> PWM_OUT_6_BIT 
> PWM_OUT_7_BIT 
bEnable 确定 信和 号 是 使 能 还 是 禁止 
该 函数 使 能 或 禁止 所 选 PWM 输出 。 使 用 参数 ui32PWMOutBits 选择 输出 。 而 参数 bEn- 
描述 able 用 于 确定 所 选 输出 的 状态 。 如 果 将 bEnable 设置 为 bue， 则 使 能 所 选 的 PWM 输出 ,或 
2 将 其 置 于 激活 状态 。 如 果 bEnable 为 false， 则 选 定 的 输出 将 被 禁止 , 或 将 其 置 于 非 激 活 
返回 参数 无 
表 J-32 PWMOutputUpdateMode 
功能 设置 PWM 输出 的 更 新 模式 或 同步 模式 
void PWMOutputUpdateMode (uint32_t ui32Base, 
函数 原型 uint32_t ui32PWMOutBits, 
uin132_t ui32 Mode ) 
ui32Base PWM 模块 的 基地 址 
ui32PWMOutBits ” 待 修改 的 PWM 输出 ， 为 下 列 值 的 逻辑 或 : 
> PWM_OUT_0_BIT 
> PWM_OUT_1_BIT 
> PWM_OUT 2_BIT 
参 数 > PWM_OUT 3_BIT 
> PWM_OUT 4_BIT 
> PWM_OUT_5_BIT 
> PWM_OUT_6_BIT 
> PWM_OUT_7_BIT 
u32Mode ” 当 使 能 或 禁止 PWM 输出 时 ， 指 定 使 能 的 更 新 使 用 模式 
该 函数 用 于 设置 三 个 候选 更 新 模式 中 的 一 种 来 使 能 或 禁止 PWM 输出 请 求 。 参 数 
ui32Mode 控制 所 做 的 更 改 需 通过 调用 PWMOutputState ( ) 来 生效 。 其 可 能 的 值 如 下 : 
> PWM_OUTPUT_MODE_NO_SYNC // 使 能 /禁止 的 变更 立即 生效 
描述 > PWM_OUTPUT_MODE_SYNC_LOCAL // 当 本 地 PWM 发 生 器 中 的 计数 器 在 下 一 
次 到 达 0 时 ， 使 改变 生效 
> PWM_OUTPUT_MODE_SYNC_CLOBAL // 当 本 地 PWM 发 生 器 中 的 计数 右 在 下 一 
次 到 达 0， 随 后 调用 PWMSyncUpdate( ) 在 其 wi32GenBits 参数 中 指定 相同 的 发 生 器 ， 使 
改变 生效 
返回 参数 无 
表 J-33 PWMPulseWidthGet 
功能 获取 PWM 输出 的 脉冲 宽度 
ーー 人 uint32 t PWMPulseWidthGet (uint32_t ui32Base, 
函数 原型 uint32_t ui32PWMOut) 
ui32Base PWM 模块 的 基地 址 
参数 ui32PWMOut PWM 输出 查询 ， 参 数 为 下 列 值 之 一 : 





> PWM_OUT 0 
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(人 
> PWM_OUT_1 
> PWM_OUT_2 
> PWM_OUT_3 
参 数 > PWM_OUT_4 
> PWM_OUT_S 
> PWM_OUT_6 
> PWM_OUT_7 
描述 该 函数 用 于 获取 指定 PWM 输出 的 当前 可 编程 脉冲 宽度 。 如 果 指 定 PWM 发 生 器 的 计数 器 
更 新 还 未 完成 ， 返 回 值 可 能 不 是 现行 的 周期 ， 而 是 用 PWM 时 钟 节拍 测量 的 编程 的 周期 
返回 参数 返回 PWM 时 钟 节拍 的 脉冲 宽度 
表 J-34 PWMPulseWidthSet 
功能 设置 指定 PWM 输出 的 脉冲 宽度 
void PWMPulseWidthSet (uint32_t ui32Base, 
函数 原型 uint32_t ni32PWMOut, 
uint32_t ui32 Width ) 
ui32Base PWM 模块 的 基地 址 
ui32PWMOut PWM 输出 查询 ， 参 数 为 下 列 值 之 一 : 
> PWM_OUT_0 
> PWM_OUT_1 
> PWM_OUT_2 
参 数 > PWM_OUT_3 
> PWM_OUT_4 
> PWM_OUT_S 
> PWM_OUT_6 
> PWM_OUT_7 
ui32 Width ”指定 脉冲 正 部 分 的 宽度 
描述 该 函数 设置 指定 PWM 输出 的 脉冲 宽度 ， 其 中 脉冲 宽度 被 定义 为 PWM 时 钟 节拍 数 
返回 参数 无 
表 J-35 PWMSyncTimeBase 
功能 让 一 个 或 多 个 PWM 发 生 器 模块 的 计数 器 同步 计数 
所 尖 四 刑 void PWMSyncTimeBase (uint32_t ui32Base， 
函数 原型 uint32_t ui32 CenBits ) 
ui32Base PWM 模块 的 基地 址 
w32GenBits 待 同 歩 的 PWM 发 生 器 模块 ， 为 下 列 值 的 逻辑 或 : 
会 六 > PWM_GEN_0_BIT 
参数 
> PWM_CEN_1_BTT 
> PWM_GEN_2_BIT 
> PWM_GEN_3_BIT 
描述 对 于 所 选 定 的 PWM 模块 ， 该 函数 通过 让 指定 发 生 器 中 的 计数 器 复位 来 同步 发 生 器 模块 
的 时 基 
返回 参数 无 
表 J-36 PWMSyncUpdate 
功能 同步 所 有 等 待 的 更 新 
函数 原型 void PWMSyncUpdate (uint32_t ui32Base, 





uint32_t ui32GenBits) 























py 


ui32Base PWM 模块 的 基地 址 
ui32GenBits 待 更新 的 PWM 发 生 器 模块 ， 为 下 列 值 的 逻辑 或 ， 
参数 > PWM_CEN_0_BIT 
加 > PWM_CEN_1_BTT 
> PWM_CEN_2_BIT 
> PWM_CEN_3_BIT 
描述 对 于 选 定 的 PWM 发 生 器 ， 该 函数 使 所 有 排队 的 周期 或 脉冲 宽度 的 更 新 在 下 一 次 相应 计 
数 器 変 妨 0 时 进行 
返 回 参 数 无 








本 章 附 录 将 介绍 PDMA 的 固件 库 函 数 ， 包 括 : 定义 文档 和 函数 文档 两 个 部 分 。 


1. 定义 文档 


介绍 RDMA 固件 库 的 定义 文档 。 


功能 


表 K-1 pDMATaskStructEntry 
构建 散 聚 任务 表 项 的 辅助 宏 





[ay 
ba 


ui32 1TtemSize , 
um32Srclncrement , 


pvSrcAddr , 


pvDstAddr, 
ui32 ArbSize , 
ui32 Mode ) 


#define uuDMATaskStructEntry (m32TransferCount , 


ui32 DstIncrement , 





Ra 
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ui32TransferCount ”传输 任务 的 项 目 计 数 
ui32ItemSize ”传输 任务 的 项 目 位 大 小 

ui32SrcIncrement 源 数 据 位 大 小 的 増量 
pvSreAddr ”传输 数据 的 起 始 地 址 
ui32DstIncrement ”目标 数据 位 大 小 的 增 量 
pvDstAddr 目标 数据 的 起 始 地 址 
ui32ArbSize ”传输 任务 的 仲裁 大 小 
ui32Mode 任务 的 传输 模式 






































这 个 宏 的 目的 是 用 来 帮助 构建 散 聚 传输 的 一 个 
算 任务 结构 体 成 员 (entry) 字段 的 值 








> 参数 ui32ItemSize 待 传输 数据 的 位 大 小 。 
或 者 UDMA_SIZE_32 中 的 一 个 值 

> 参数 ui32SrcIncrement 
UDMA_SRC_INC_16 、UDMA_SRC_INC_32 ， 


























其 值 为 1 ~ 1024 





// 是 源 数据 增加 的 大 小 。 


RDMA 任务 表 。 这 个 宏 将 根据 输入 参数 计 











对 每 个 参数 的 值 有 特殊 要 求 。 由 于 不 做 检查 ， 所 以 调用 者 要 保证 使 用 的 参数 值 是 正确 的 
> 参数 ui32TransferCount 待 传输 的 任务 项 目 数量 。 它 
它 必须 是 UDMA_SIZE_8、 UDMA_SIZE_16, 


的 值 必须 在 1 ~ 1024 之 间 


它 的 值 必 须 是 UDMA_SRC_INC_8、 
或 者 UDMA_SRC_INC_NONE 中 的 一 个 值 


> 参数 pvSrcAddr 指向 源 数据 起 始 地 址 的 空 指针 

> 参数 ui32DstInerement 目标 数据 的 增 量 大 小 。 它 必须 是 UDMA_DST_INC_8、UDMA_ 
DST_INC_16、UDMA_DST_INC_32, 或 者 UDMA_DST_INC_NONE 中 的 一 个 值 

> 参数 pyDstAddr 指向 将 要 传输 的 标 数 据 的 初始 地 址 的 空 指针 

> 参数 ui32ArbSize 传输 数据 的 仲裁 大 小 ， 它 的 值 必须 是 UDMA_ARB_1、UDMA_ARB_2、 
UDMA_ARB_4 … UDMA_ARB_1024 中 的 一 个 。 此 参数 为 2 的 究 用 于 选择 仲裁 大 小 ， 
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> 参数 ui32Mode 传输 任务 的 模式 。 它 必须 是 UDMA_MODE_BASIC 、UDMA_MODE_AU- 
TO 、UDMA_MODE_MEM_SCATTER_CATHER, 或 者 UDMA_MODE_PER_SCATTER_ 
GATHER 中 的 一 个 值 

例如 ， 宏 可 用 来 初始 化 DMAControlTable 结构 体 中 的 各 个 成 员 : 


tDMAControlTable MyTaskList[ ] = 


1 





uDMATaskStructEntry( Task1Count, 








描述 UDMA_SIZE 8 
UDMA_SRC_INC_8, 
MySourceBuf, 
UDMA_DST_INC_8, 
MyDestBuf , 
UDMA_ARB_8, 
UDMA_MODE_MEM_SCATTER_CATHER ) , 
uDMATaskStructEntry (Task2Count, ... ) , 
1 
| 
返回 参数 无 





2. 函数 文档 





介绍 PDMA 的 固件 库 库 函数 的 功能 及 定义 。 


表 K-2 puDMAChannelAssign 

























































































功能 分 配 RDMA 通道 的 外 设 映射 
函数 原型 void RDMAChannelAssign (uint32_t ui32Mapping) 
参数 ui32Mapping 指定 通道 外 设 分 配 的 宏 
该 函数 给 ADMA 通道 分 配 一 个 外 设 映射 ， 用 于 选择 哪个 外 设 为 DMA 通道 。 参 数 
描述 ui32 Mapping 为 头 文件 udma. h 中 命名 为 UDMA_CHn tttt 中 的 一 个 宏 。 例 如 ， 把 LDMA 通 道 
0 分 配给 UART2 RX 通道 ， 则 参数 就 应 该 为 宏 UDMA_CHO_UART2RX 
返回 参数 无 
表 K-3 puDMAChannelAttributeDisable 
功能 禁止 pDMA 通道 的 属性 
函数 原型 void WDMAChannelAttributeDisable (uint32_t ui32ChannelNum , 
RE uint32_t ui32 At ) 
参数 ui32ChannelNum ， 待 配置 的 通道 
ui32 Attr 通道 的 属性 组 合 
该 函数 用 于 禁止 uDMA 通道 的 属性 
参数 32Atr 为 以 下 任意 值 的 逻辑 或 . 
描述 > UDMA_ATTR_USEBURST // 用 于 限制 传输 仅 适用 突 发 模式 
HU > UDMA_ATTR _ALTSELECT // 用 于 选择 该 通道 的 副 控制 结构 
> UDMA_ATTR_HIGH_PRIORITY // 用 于 设置 该 信道 为 高 优先 级 
> UDMA_ATTR_REQMASK // 屏 蔽 该 通道 来 自 外 设 的 硬件 请 求 信 和 号 
返回 参数 无 
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功能 


表 K-4 pnDMAChannelAttributeEnable 








使 能 DMA 通道 的 属性 





函数 原型 


void nDMAChannelAttributeEnable (uint32_t ui32ChannelNum , 
uint32_t ui32Attr) 





ui32ChannelNum ” 待 配置 的 通道 
ui32Attr 通道 的 属性 组 合 

















该 函数 用 于 使 能 一 个 LDMA 通道 的 属性 

参数 32Atr 为 以 下 任意 值 的 逻辑 或 . 

> UDMA_ATTR_USEBURST // 用 于 限制 传输 仅 适用 突 发 模式 
> UDMA_ATTR _ALTSELECT // 用 于 选择 该 通道 的 副 控制 结构 
> UDMA_ATTR_HICH_PRIORITY /用 于 设置 该 信道 为 高 优先 级 



































> UDMA_ATTR_REQMASK / 屏 项 该 通道 来 自 外 设 的 硬件 请 求 信号 
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功能 


无 


表 K-5 pnDMAChannelAttributeGet 








获取 LDMA 通道 的 属性 使 能 





函数 原型 


hint32_t pDMAChannelAttributeGet (uint32_t ui32ChannelNum) 





参数 


ui32ChannelNum ” 待 配置 的 通道 





描述 





该 函数 返回 代表 wDMA 通道 属性 标志 的 组 合 








a 
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W 
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功能 








返回 ADMA 通道 属性 的 逻辑 或 ， 为 下 列 值 之 一 : 

> UDMA_ATTR_USEBURST // 用 于 限制 传输 仅 适用 突 发 模式 
> UDMA_ATTR _ALTSELECT // 用 于 选择 该 通道 的 副 控制 结构 
> UDMA_ATTR_HIGH_PRIORITY ”// 用 于 设置 该 信道 为 高 优先 级 














> UDMA_ATTR_REQMASK // 屏 蔽 该 通道 来 自 外 设 的 硬件 请 求 信 和 号 


表 K-6 nuDMAChannelControlSet 


设置 LDMA 通道 控制 结构 的 控制 参数 





函数 原型 


void WDMAChannelControlSet (uint32_t ui32ChannelStructIndex , 
uint32_t m32Control ) 





参数 


ui32ChannelStructIndex phDMA 通道 号 与 UDMA_PRI_SELECT 或 UDMA_ALT_SELECT 的 


逻辑 或 
ui32Control 设置 通道 控制 参数 的 几 个 控制 值 的 逻辑 或 


























该 函数 用 于 设置 LDMA 传输 的 控制 参数 。 这 些 参 数 是 典型 值 ， 通 常 不 会 改变 








> 参数 ui32ChannelStructIndex 应 该 是 信道 号 与 UDMA_PRI_SELECT 或 UDMA_ALT_SE- 














LECT 之 一 的 逻辑 或 ， 以 选择 是 使 用 主 数据 结构 还 是 副 数 据 结构 





> 参数 ui32Control 是 以 下 五 个 值 的 逻辑 或 : 数据 大 小 、 源 地 址 增 量 、 目 标 地 址 增 量 、 








裁 大 小 以 及 使 用 突 发 标志 
每 个 这 些 值 的 可 用 选择 描述 如 下 : 











仲 


加 从 UDMA_SIZE_8 、 UDMA_SIZE_16 或 UDMA_SIZE_32 中 选择 一 个 数据 大 小 ,来 选取 


大 小 为 8、16 或 者 32 位 的 数据 


加 从 UDMA_SRC_INC_8、UDMA_SRC_INC_16、UDMA_SRC_INC_32 或 者 UDMA_SRC 











INC_NONE 中 选择 一 个 源 地 址 增 量 大 小 ， 来 选取 8 位 字 节 、16 位 半 字 、32 位 字 或 者 


选择 无 地 址 增 量 


加 从 UDMA_DST_INC_8、UDMA_DST_INC_16、UDMA_DST_INC_32 或 者 UDMA_DST_ 
INC_NONE 中 选择 一 个 目标 地 址 增 量 ， 可 选取 大 小 为 8 位 字 节 、16 位 半 个 字 、32 位 

















字 或 者 选择 无 地 址 增 量 








時 仲裁 大 小 决定 了 在 LDMA 控制 器 重新 仲裁 总 线 之 前 传输 了 多 少 个 项 目 。 可 从 UDMA_ 
ARB_1、UDMA_ARB_2、UDMA_ARB_4、UDMA_ARB_8、…UDMA_ARB_1024 的 1 ~ 





























1024 个 项 目 中 选择 仲裁 的 大 小 ， 其 值 为 2 的 震 














加 值 UDMA_NEXT_USEBURST 用 于 强制 通道 在 散 聚 传输 的 末端 只 响应 突 发 请 求 
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无 


475 


表 K-7 nuDMAChannelDisable 










































































































































































功能 禁止 pDMA 通道 的 操作 
函数 原型 void rkLDMAChannelDisable (uin32_t ui32ChannelNum) 
参数 ui32ChannelNum 待 禁 止 的 信 道 号 
描述 该 函数 禁止 特定 的 nDMA 通道 。 一旦 禁止 ,该 通道 只 有 通过 kDMAChannelEnable( ) 函数 
对 其 重新 使 能 后 ， 方 可 对 pDMA 传输 请 求 做 出 响应 
返回 参数 无 
表 K-8 pDMAChannelEnable 
功能 使 能 LDMA 通道 的 操作 
函数 原型 void LDMAChannelEnable (uint32_t ui32ChannelNum ) 
参数 ui32ChannelNum ” 待 使 能 的 信道 号 。 
该 函数 使 能 一 个 使 用 的 特定 的 pDMA 通道 。 并 且 该 函数 必须 在 通道 执行 LDMA 传输 之 
, 前 使 能 
术 SN の ye 
描述 当 一 个 pDMA 传输 完成 时 ，pDMA 控制 器 将 自动 禁止 通 该 道 。 因 此 ， 这 个 函数 应 该 在 启 
动 任何 新 的 传输 前 先行 调用 
返回 参数 无 
表 K-9 puDMAChannellsEnabled 
功能 检查 是 否 使 能 一 个 ADMA 通道 的 操作 
函数 原型 bool ukDMAChannellsEnabled (uint32_t ui32ChannelNum ) 
参 数 um32ChannelNum 待 检 查 的 信道 号 
描述 该 函数 用 于 检查 一 个 特定 的 wDMA 信道 是 否 被 使 能 。 在 一 个 传输 结束 自动 禁止 该 通道 传 
输 时 ， 这 个 函数 可 用 来 检查 传输 的 状态 
返回 参数 如 果 返 回 true， 则 通道 使 能 ; 如 果 返 回 false， 则 禁止 通道 传输 
表 K-10 npDMAChannelModeGet 
功能 获取 一 个 LDMA 通道 控制 结构 的 传输 模式 
語数 原型 uint32_t 
函数 原 uDMAChannelModeCet (uint32_ t ui32ChannelStructIndex) 
A ui32ChannelStructIndex pkDMA 通道 号 与 UDMA_PRI_SELECT 或 UDMA_ALT_SELECT 之 
参 数 A 
一 的 逻辑 或 
描述 该 函数 用 于 获取 ikDMA 通道 的 传输 模式 ， 并 且 查 询 通道 上 的 传输 状态 。 当 传输 完成 时 模 


式 将 为 UDMA_MODE_STOP 
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返回 指定 通道 传输 模式 和 控制 结构 ， 为 下 列 值 之 一 : 
> UDMA_MODE_STOP 
> UDMA_MODE_BASIC 
> UDMA_MODE_AUTO 
> UDMA_MODE_PINGPONG 

> UDMA_MODE_MEM_SCATTER_GATHER 
> UDMA_MODE_PER_SCATTER_GATHER 





表 K-11 pDMAChannelRequest 
































































































































功能 请 求 pDMA 通道 启动 传输 
函数 原型 void WDMAChannelRequest (uint32_t ui32ChannelNum ) 
参数 ui32ChannelNum 请求 LDMA 传输 的 通道 号 
描述 该 函数 允许 软件 请 求 一 个 pDMA 通道 开始 传输 。 该 函数 可 用 于 执行 存储 器 一 存储 器 的 传 
输 ， 或 由 于 某 些 原因 ， 一 次 传输 需 由 软件 启动 ， 而 非 与 该 通道 相关 联 的 外 设 来 开始 
返回 参数 无 
表 KK-12 pDMAChannelScatterGatherSet 
功能 配置 LDMA 通道 的 散 聚 模式 
void WDMAChannelScatterGatherSet (uint32_t ui32ChannelNum ， 
7 本 電 uint32_t ui32TaskCount , 
函数 原型 void * pvTaskList, 
uint32_t ui32IsPeriphSG ) 
ui32ChannelNum RDMA 通 道 号 
参 数 ui32TaskCount ” 待 执 行 的 散 聚 任务 数 
= pvTaskList ”指向 散 聚 任务 列表 开始 的 指针 
ui32IsPeriphSG ”指示 一 个 外 设 散 聚 传输 的 标志 (否则 为 存储 器 散 聚 传输 ) 
该 函数 用 于 配置 散 聚 模式 的 通道 。 调 用 者 必须 先行 建立 一 个 任务 列表 ， 且 必须 传递 参数 
描述 pvTaskList 指向 任务 列表 的 开始 。 参 数 ui32TaskCount 为 任务 列表 中 的 任务 计数 ， 而 非 任 务 
列表 的 大 小 。 标 志 blsPeriphSG 用 于 指示 散 聚 是 配置 为 外 设 操作 还 是 存储 器 操作 
返回 参数 无 
表 K-13 pDMAChannelSelectDefault 
功能 选择 默认 外 设 的 一 组 LDMA 通道 
函数 原型 void WDMAChannelSelectDefault (uint32_t ui32DefPeriphs ) 
参 数 ui32 DefPeriphs 使 用 默认 外 设 的 kDMA 通道 的 逻辑 或 ， 而 非 第 二 外 设 
该 函数 用 于 选择 默认 外 设 分 配 的 一 组 nDMA 通道 
参数 ui32DefPeriphs 为 下 列 任意 宏 的 逻辑 或 : 
> UDMA_DEF_USBEP1RX_SEC_UART2RX 
> UDMA_DEF_USBEPITX_SEC_UART2TX 
> UDMA_DEF_USBEP2RX_SEC_TMR3A 
> UDMA_DEF_USBEP2TX_SEC_TMR3B 
UDMA_DEEF_USBEP3RX_SEC_TMR2A 
MA_DEF_USBEP3TX_SEC_TMR2B 
MA_DEF_ETHORX_SEC_TMR2A 
MA_DEF_ETHOTX_SEC_TMR2B 
MA_DEF_UARTORX_SEKC_UART1RX 
MA_DEF_UARTOTX_SEC_UART1TX 
描述 MA_DEF_SSIORX_SEC_SSIIRX 





MA_DEF_RESERVED_SEC_UART2RX 
MA_DEF_RESERVED_SEC_UART2TX 
MA_DEF_ADCOO_SEC_TMR2A 
MA_DEF_ADCO1_SEC_TMR2B 
MA_DEF_ADCO2_SEC_RESERVED 
MA_DEF_ADCO3_SEC_RESERVED 
MA_DEF_TMROA_SEC_TMR1A 
MA_DEF_TMROB_SEC_TMR1B 
MA_DEF_TMRIA_SEC_EPIORX 
MA_DEF_TMR1B_SEC_EPIOTX 
MA_DEF_UARTIRX_SEC_RESERVED 





D 
D 
D 
D 
D 
D 
D 
D 
D 
D 
D 
DMA_DEF_SSIOTX_SEC_SSI1TX 
D 
D 
D 
D 
D 
D 
D 
D 
D 
D 
D 
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> UDMA_DEF_UARTITX_SEC_RESERVED 
> UDMA_DEF_SSIIRX_SEC_ADC10 
> UDMA_DEF_SSIITX_SEC_ADC11 






























































描述 > UDMA_DEF_RESERVED_SEC_ADC12 

> UDMA_DEF_RESERVED_SEC_ADC13 

> UDMA_DEF_I2SORX_SEC_RESERVED 

> UDMA_DEF_I2SOTX_SEC_RESERVED 
返回 参数 无 

表 K-14 pDMAChannelSelectSecondary 

功能 选择 一 组 DMA 通道 的 第 二 外 设 
函数 原型 void WDMAChannelSelectSecondary (uint32_t ui32SecPeriphs) 
参数 ui32SecPeriphs 于 用 第 二 外 设 的 kDMA 通道 的 逻辑 或 ， 而 非 默 认 的 外 设 

该 函数 用 于 为 一 组 DMA 通道 选择 第 二 外 设 分 配 。 通 过 选择 通道 的 第 二 外 设 分 配 ， 使 默 

认 的 外 设 不 再 对 该 通道 有 效 

参数 ui32SecPeriphs 为 下 列 任意 宏 的 逻辑 或 ， 

> UDMA_DEEF_USBEP1RX_SEC_UART2RX 

> UDMA_DEF_USBEP1ITX_SEC_UART2TX 

> UDMA_DEF_USBEP2RX_SEC_TMR3A 

> UDMA_DEF_USBEP2TX_SEC_TMR3B 

> UDMA_DEF_USBEP3RX_SEC_TMR2A 

> UDMA_DEF_USBEP3TX_SEC_TMR2B 

> UDMA_DEF_ETHORX_SEC_TMR2A 

> UDMA_DEF_ETHOTX_SEC_TMR2B 

> UDMA_DEF_UARTORX_SEC_UART1RX 

> UDMA_DEF_UARTOTX_SEC_UART1TX 

> UDMA_DEF_SSIORX_SEC_SSI1RX 

> UDMA_DEF_SSIOTX_SEC_SSI1TX 

> UDMA_DEF_RESERVED_SEC_UART2RX 
描述 > UDMA_DEF_RESERVED_SEC_UART2TX 

> UDMA_DEF_ADCOO_SEC_TMR2A 

> UDMA_DEF_ADCO1_SEC_TMR2B 

> UDMA_DEF_ADCO2_SEC_RESERVED 

> UDMA_DEF_ ADC03_SEC_RESERVED 

> UDMA_DEF_TMROA_SEC_TMR1A 

> UDMA_DEF_TMROB_SEC_TMR1B 

> UDMA_DEF_TMRIA_SEC_EPIORX 

> UDMA_DEF_TMR1B_SEC_EPIOTX 

> UDMA_DEF_UART1RX_SEC_RESERVED 

> UDMA_DEF_UARTITX_SEC_RESERVED 

> UDMA_DEF_SSI1RX_SEC_ADC10 

> UDMA_DEF_SSIITX_SEC_ADC11 

> UDMA_DEF_RESERVED_SEC_ADC12 

> UDMA_DEF_RESERVED_SEC_ADC13 

> UDMA_DEF_I2SORX_SEC_RESERVED 

> UDMA_DEF_I2SOTX_SEC_RESERVED 
返 回 参 数 无 

表 KK-1S pDMAChannelSizeGet 

功能 获取 wDMA 通道 控制 结构 的 当前 传输 大 小 
函数 原型 uint32_t 





HDMAChannelSizeGet (uint32_t ui32ChannelStructIndex) 





( 续 ) 
ui32ChannelStructIndex phDMA 信道 号 与 UDMA_PRI_SELECT 或 UDMA_ALT_SELECT 之 
一 的 欣 辑 或 














该 函数 用 于 获取 通道 的 wDMA 传输 大 小 。 传 输 的 大 小 就 是 待 传输 的 项 目 个 数 ， 其 中 项 目 
大 小 可 能 是 8 、16 或 32 位 。 如 果 只 发 生 了 部 分 传输 ， 则 将 返回 剩余 项 目的 个 数 。 如 果 传 
输 完成 ， 则 返回 值 为 0 


















































i 返回 待 传输 剩余 项 目的 个 数 


功能 


表 K-16 pDMAChannelTransferSet 


设置 DMA 通道 控制 结构 的 传输 参数 





函数 原型 


void WDMAChannelTransferSet (uint32_t ui32ChannelStructIndex, 
uint32_t ui32 Mode, 
void * pvSrcAddr ， 
void * pvDstAddr， 
uint32_t ui32TransferSize ) 





ui32 ChannelStructIndex ppDMA 信道 号 与 UDMA_PRI_SELECT 或 者 UDMA_ALT_SELECT 
的 逻辑 或 

ui32Mode MDMA 传输 的 类 型 

pvSrcAddr 传输 的 源 地 址 

pvDstAddr 传输 的 目标 地 址 

ui32TransferSize 待 佐 輸 的 数 据 項 目 介 数 




















该 函数 用 于 配置 LDMA 传输 的 参数 。 通 常 这 些 参数 是 经 常 改变 的 。 该 通道 在 调用 这 个 函 
数 之 前 ， 必 须 至 少 先 行 调用 RDMAChannelControlSet( ) 一 次 
参数 ui32ChannelStructIndex 应 为 通道 号 与 UDMA_PRI_SELECT 或 UDMA_ALT_SELECT 的 
让 辑 或 ,以 选择 是 主 数据 结构 还 是 副 数 据 结 构 
> 参数 ui32Mode 应 为 下 列 值 之 一 : 
国 UDMA_MODE_STOP /停止 pDMA 传输 。 在 传输 结 束 时 控制 器 将 模式 设 定 为 该 值 
箇 UDMA_MODE_BASIC // 执 行 基于 请 求 的 基本 传输 
箇 UDMA_MODE_AUTO// 传 输 一 旦 开始 ， 执 行 的 传输 总 是 会 完成 ， 即 使 取消 请 求 
加 UDMA_MODE_PINGPONG // 建 立 一 个 在 主 控 制 结构 与 副 控制 结构 之 间 切 换 的 传输 
通道 ， 该 模式 允许 在 uDMA 传输 中 使 用 乒乓 缓冲 
加 UDMA_MODE_MEM_SCATTER_CATHER // 建 立 一 个 存储 器 散 聚 传输 
画 UDMA_MODE_PER_SCATTER_GATHER// 建 立 一 个 外 设 散 聚 传输 
> 参数 pvSrcAddr 和 pvDstAddr 指向 待 传输 数据 存储 单元 首 地 址 的 指针 。 这 些 地 址 应 根据 
项 目 大 小 对 齐 。 如 果 指 针 是 指向 适当 数据 类 型 的 存储 单元 ， 编 译 器 将 负责 这 种 对 齐 
操作 
> 参数 ui32TransferSize 数据 的 项 目 个 数 ， 而 非 字 节 数 
两 种 散 聚 模式 ， 即 存储 器 和 外 设 实际 上 是 不 同 的 ， 这 取决 于 选择 主 控制 结构 还 是 副 控制 
结构 。 该 函数 寻找 UDMA_PRI_SELECT 和 UDMA_ALT_SELECT 的 标志 与 通道 号 ， 并 为 主 
控制 结构 和 副 控制 结构 设置 适当 的 散 聚 模式 
在 调用 该 函数 之 后 ， 通 道 必须 调用 ADMAChannelEnable( ) 来 使 能 。 只 有 在 配置 好 通道 与 
通道 使 能 之 后 ， 才 能 进行 数据 传输 。 注 意 ， 通 道 在 传输 完成 之 后 将 自动 关闭 。 即 在 建立 好 
下 次 传输 之 后 ， 必 须 再 调用 一 次 uDMAChannelEnable( ) 函数 来 使 能 传输 通道 
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表 K-17 pDMAControlAlternateBaseGet 


获取 通道 控制 表 副 结构 的 基地 址 





函数 原型 


void * RDMAControlAlternateBaseCet ( void ) 





描述 








该 函数 获取 用 于 保存 副 控 制 结构 的 通道 控制 表 下 半 部 分 的 基地 址 











返回 参数 

















返回 一 个 指向 通道 控制 表 下 半 部 分 的 基地 址 
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表 K-18 nuDMAControlBaseGet 




































































































































































功能 获取 通道 控制 的 表 基 地 址 
函数 原型 void * uDMAControlBaseGet (void ) 
描述 该 函数 获取 通道 控制 表 的 基地 址 。 这 个 表 驻 留 在 系统 存储 器 中 ， 并 且 用 于 保存 每 个 
日 时 LDMA 通道 的 控制 信息 
返回 参数 返回 指向 通道 控制 表 的 基地 址 的 指针 
表 K-19 uDMAControlBaseSet 

功能 设置 通道 控制 表 的 基地 址 
函数 原型 void uDMA ControlBaseSet (void * psControlTable ) 
参数 psControlTable 指向 RDMA 通道 控制 表 中 以 1024 字 节 对 齐 的 基地 址 的 指针 

该 函数 配置 通道 控制 表 的 基地 址 。 该 表 驻 留 在 系统 存储 器 中 ， 用 于 保存 每 个 kDMA 通道 
描述 的 控制 信息 。 此 表 必 须 以 1024 字 节 的 边界 对 齐 ， 并 且 基 地 址 必须 在 使 用 任何 通道 函数 之 

前 配置 

通道 控制 表 的 大 小 由 wDMA 通道 的 个 数 和 使 用 的 传输 模式 决定 

返回 参数 无 
表 K-20 uDMADisable 
功能 禁止 pDMA 控制 器 的 使 用 
函数 原型 void uDMADisable ( void ) 
描述 该 函数 禁止 pDMA 控制 器 。 一 旦 被 禁止 ， 在 未 调用 uDMAEnable( ) 来 重新 使 能 LDMA 控 
制 器 之 前 ， 该 wDMA 控制 需 不 能 被 操作 
返回 参数 无 
表 K-21 uDMAEnable 
功能 使 能 pDMA 控制 器 的 使 用 
函数 原型 void uDMAEnable (void ) 
描述 该 函数 使 能 wDMA 控制 器 。 在 配置 和 使 用 wDMA 之 前 ， 必 须 首先 使 能 nDMA 控制 器 
返回 参数 无 
表 K-22 uDMAErrorStatusClear 

功能 清除 pDMA 的 错误 中 断 
函数 原型 void uDMAErrorStatusClear (void ) 
描述 该 函数 清除 挂 起 的 wDMA 错误 中 断 。 应 在 wDMA 错误 中 断 处 理 程 序 中 调用 该 函数 来 清 








除 中 断 
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表 K-23 uDMAErrorStatusGet 
































功能 获取 wDMA 的 错误 状态 

函数 原型 uint32_t uDMAErrorStatusGet (void) 

描述 该 函数 返 回 RDMA 的 错误 状态 。 应 在 pDMA 错误 中 断 处 理 程序 中 调用 该 函数 ， 以 确定 
是 否 发 生 了 pjDMA 错误 

返回 参数 如果 pDMA 错误 挂 起 ， 则 返回 非 零 值 
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表 K- 


24 uDMAIntClear 








































































































































































































功能 清除 LDMA 的 中 断 状态 
函数 原型 void uDMAIntClear (uint32_t ui32ChanMask ) 
参数 ui32ChanMask 32 位 屏蔽 位 ， 每 一 个 位 对 应 一 个 pDMA 通道 
该 函数 清除 在 ui32ChanMask 设置 的 上 DMA 中 断 状态 寄存 器 中 的 位 。 每 个 通道 对 应 其 中 
描述 的 一 位 。 如 果 一 个 位 在 ui32ChanMask 中 置 位 ， 则 相应 通道 的 中 断 状态 将 被 清除 (如 果 它 
被 置 位 ) 
返回 参数 无 
表 K-25 uDMAIntRegister 
功能 注册 pDMA 控制 器 的 中 断 处 理 程序 
ー | void uDMAIntRegister (uint32_t ui32IntChannel, 
函数 原型 void ( * pfnHandler) (void)) 
参数 ui32IntChannel 确定 待 注册 的 LDMA 中 断 
= pfnHandler 指向 在 中 断 激活 时 被 调 函 数 的 指针 
该 函数 在 pDMA 控制 器 产生 中 断 时 注册 和 使 能 被 调用 的 处 理 程序 
参数 ui32IntChannel 为 下 值 之 一 : 
描述 > UDMA_INT_SW /7 注册 中 断 处 理 程序 来 处 理 nDMA 软件 通道 的 中 断 (UDMA_ 
CHANNEL_SW ) 
> UDMA_INT_SW /注册 中 断 处 理 程序 来 处 理 pDMA 的 错误 中 断 
返回 参数 无 
表 K-26 uDMAIntStatus 
功能 获取 LDMA 控制 器 通道 中 断 状态 
函数 原型 uint32_t uDMAIntStatus (void ) 
该 函数 用 于 获取 gDMA 控 制 益 的 中 断 状 恋 。 返 回 一 人 32 位 的 位 屏蔽 ， 它 表明 哪个 通道 
描述 正在 请 求 中 断 。 该 函数 可 以 用 来 在 中 断 处 理 程序 中 决定 或 确认 哪个 LDMA 信道 请 求 了 一 个 
中 断 
反 回 参数 返回 一 个 32 位 屏 藏 ， 以 指示 请 求 的 pDMA 通道 。 每 个 通道 对 应 有 一 个 位 ，1 表示 该 信 
a 道 有 中 断 请 求 ， 且 可 以 置 位 多 个 位 
表 K-27 uDMAImtUnregister 
功能 注销 ADMA 控制 器 的 中 断 处 理 程序 
函数 原型 void uDMAIntUnregister (umt32_t ui32IntChannel ) 
参数 ui32IntChannel 确定 待 注销 的 RDMA 中 断 
描述 该 函数 用 于 禁止 和 注销 指定 = WDMA 中 断 调用 的 中 断 处 理 程序 。 参 数 ui32IntChannel 为 
la UDMA_INT_SW 或 UDMA_INT_ERR 其 中 之 一 ， 见 表 K-25 中 的 介绍 
返回 参数 无 








< 附录 L 第 14 章 附 录 : USB DriverLib 固件 库 函 数 简介 





本 章 附 录 将 介绍 通用 USB API 函数 的 用 法 ， 详 细 的 USB 固件 库 请 参考 TI 的 TivaWare™ 
USB Library USER”S GUIDE 文档 ( 见 文档 : SW - TM4C - USBL - UG -2.0.1.11577)。 
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表 L-1 USBClockDisable 









































































































































































































































功能 禁止 USB 控制 器 PHY 的 时 钟 
函数 原型 void USBClockDisable (uint32_t ni32 Base ) 
参数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 禁止 USB PHY 的 时 钟 输入 或 输出 
返回 无 
表 工 -2 USBClockEnable 
功能 配置 和 使 能 USB 控制 器 PHY 的 时 钟 
void USBClockEnable (uint32_t ui32 Base , 
函数 原型 uint32_t ui32 Div , 
uint32_t ui32 Flags ) 
ui32Base 指定 USB 模块 基地 址 
参数 ui32Div 指定 输入 时 钟 的 分 频 比 
ui32Flags 指定 USB 时 钟 使 用 哪个 时 钟 
函数 配置 和 使 能 USB PHY 时 钟 作为 USB 控制 器 的 输入 ,或 者 作为 与 输出 外 部 连接 到 
USB PHY 。 ui32Flags 参数 可 用 下 列 值 指定 时 钟 源 : 
> USB_CLOCK_INTERNAL // 使 用 内 部 时 钟 作为 USB PHY 的 时 钟 源 
描述 > USB_CLOCK_EXTERNAL // 指 定 USBOCLK 输入 引 脚 作为 USB PHY 的 时 钟 源 
如果 指定 USB_CLOCK_INTERNAL， 则 参数 ui32Div 用 来 指定 内 部 时 钟 的 分 频 比 ， 如果 指 
定 USB_CLOCK_EXTERNAL， 那 么 将 忽 上 ui32Div。 当 指定 USB_CLOCK_INTERNAL 时 ， 则 
必须 设置 ui32Div 的 值 ， 以 便 由 PLL_VCO/ui32Div 得 到 60 MHz 时 钟 
返回 当前 的 设备 地 址 
表 L-3 USBControllerVersion 
功能 返回 该 USB 控制 器 的 版 本 
函数 原型 uint32 t USBControllerVersion (uint32_t ui32Base) 
参数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 返回 USB 控制 器 的 版 本 号 ， 可 用 于 调整 Tiva 系列 中 USB 控制 器 之 间 的 细微 差别 。 
1 所 返回 的 值 为 USB_CONTROLLER_VER_0 及 USB_CONTROLLER_VER_1 
返回 这 个 函数 返回 USB_CONTROLLER_VER_ values 中 的 值 之 一 
表 L-4 USBDevAddrGet 
功能 返回 在 设备 模式 中 的 当前 设备 地 址 
函数 原型 uint32_t USBDevAddrGet (uint32_t ui32Base ) 
参数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 返回 当前 设备 的 地 址 。 该 地 址 可 通过 调用 USBDevAddrSet( ) 来 设置 
返回 当前 的 设备 地 址 
表 L-5 USBDeyAddrSet 
功能 设置 在 设备 模式 下 的 地 址 
函数 原型 void USBDevAddrSet ( uint32_t ni32Base uint32_t ui32 Address ) 
参 数 ui32Base 指定 USB 模块 基地 址 
的 ui32Address 设备 待 使 用 的 地 址 
描述 该 函数 用 于 配置 USB 总 线 上 的 设备 地 址 。 这 个 地 址 很 可 能 是 接收 来 自主 机 控制 器 的 地 址 
设置 命令 
返回 无 
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表 L-6 USBDevConnect 















































































































































功能 在 设备 模式 中 把 USB 控制 器 连接 到 总 线 上 
函数 原型 void USBDevConnect (uint32_t ui32Base ) 
参数 u32Base 指定 USB 模块 基地 址 
描述 函数 使 能 USB 控制 器 的 软 连接 功能 。 调 用 USBDevDisconnect( ) 就 可 从 总 线 上 拿 掉 USB 
设备 
返回 无 
表 L-7 USBDevDisconnect 
功 负 在 设备 模式 中 从 总 线 上 移 除 USB 控制 器 
函数 原型 void USBDeyDisconnect (uint32_t mn32 Base ) 
参数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 使 用 USB 控制 器 的 软 连接 功能 来 清除 USB 总 线 上 的 设备 。 调 用 USBDevConnect( ) 
可 重新 使 设备 连接 到 总 线 上 
返回 无 
表 L-8 USBDevEndpointConfigGet 
功能 获取 一 个 端点 的 当前 配置 
void USBDevEndpointConfigGet (uint32_t ui32Base, 
小 [下 和 | uint32_t un32Endpoint, 
函数 原型 uint32_t * pui32MaxPacketSize, 
uint32_t * pui32Flags) 
ui32Base 指定 USB 模块 基地 址 
ui32Endpoint ” 待 访问 的 端点 
参数 pui32MaxPacketSize ”指向 写 入 该 端点 的 最 大 数据 包 大 小 的 指针 
pui32Flags 指向 写 和 人 当前 端点 设置 的 指针 。 IO 该 指 ES 含 USB_EP_ 
DEV_IN 或 USB_EP_DEV_OUT 之 一 ， 以 指示 查询 的 是 IN 端点 还 是 OUT 端点 
描述 该 函数 返回 从 机 模式 下 一 个 端点 的 基本 配置 。 这 个 端点 在 pulMaxPacketSize 和 pulFlags 返 
貞松 回 的 值 ， 相 当 于 lMaxPacketSize 和 pulFlags 之 前 传递 给 USBDevEndpointConfigSet( ) 的 值 
返 区 无 
表 L-9 USBDevEndpointConfigSet 
功能 设置 一 个 端点 的 配置 
void USBDevEndpointConfigSet (uint32_t ui32Base, 
語数 原型 uint32_t ui32 Endpoint, 
函数 原 uint32_t ui32 MaxPacketSize , 
uint32_t ui32Flags) 
u32Base 指定 USB 模块 基地 址 
参数 u32Endpoint ” 待 访问 的 端点 
0 ui32MaxPacketSize 端点 的 最大 数 据 包 大 小 
ui32Flags 用 于 配置 其 他 断 点 的 设置 
该 函数 设置 在 从 机 模式 下 端点 的 基本 配置 。 由 于 端点 0 无 动态 配置 ， 所 以 该 函数 不 能 
端点 0 调用 。 参 数 ui32flags 可 决定 某 些 参 数 的 配置 ， 而 其 他 参数 提供 了 剩余 部 分 的 配置 
描述 > USB_FEP_MODE _ 标志 // 用 于 定义 给 定 端点 的 类 型 
a > USB_EP_MODE_CTRL // 控 制 端点 
> USB_EP_MODE_ISOC // 等 时 端点 
> USB_EP_MODE_BULK // 批 量 端点 
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> USB_EP_MODE_INT 
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控制 占 ” 一 节 


// 中 断 端点 











SB_EP_DMA_MODE 标志 





















































于 确定 DMA 访问 端点 数据 FIFO 
器 的 配置 和 使 用 来 选择 DMA 的 模式 。 更 多 的 DMA 配置 信息 请 




















的 类 型 。 可 根据 DMA 控制 








在 配置 IN 端点 时 ， 当 ui32MaxPacketSize 个 数据 字 节 一 经 写 入 
AUTO_SET 位 将 立即 启动 USB 总 线 上 该 端点 的 数据 自动 传输 。 
































参阅 “使 用 USB 与 UDMA 





FIFO 中 , 指定 的 USB_EP_ 
该 选项 通常 用 于 在 无 DMA 


























































































































交互 式 要 求 时 启动 数据 传输 
在 配置 一 个 OUT 端点 时 ， 一旦 FIFO 有 足够 的 空间 能 接收 超过 ui32MaxPacketSize 个 字 节 
的 数据 ， 指 定 的 USB_EP_AUTO_REQUEST 位 将 触发 接收 更 多 的 数据 请 求 。 另 外 ， 对 于 
OUT 端点 , 一旦 从 FIFO 读 取 数 据 ，USB_EP_AUTO_CLEAR 位 可 用 来 自动 清除 数据 包 准 备 
好 标志 。 如 果 不 使 用 此 选项 ， 此 标志 必须 通过 调 USBDevEndpointStatusClear ( ) 函数 来 
手动 清除 。 这 两 种 设置 可 用 于 在 DMA 模式 下 消除 额外 的 调用 需求 
返回 无 
表 L-10 USBDevEndpointDataAck 
功能 在 设备 模式 下 对 从 给 定 端点 的 FIFO 中 读 取 数据 的 应 答 
void USBDevEndpointDataAck (uint32_t ui32 Base , 
函数 原型 uint32_t ni32Endpoint , 
bool blsLastPacket ) 
u32Base 指定 USB 模块 基地 址 
参 数 ui32Endpoint ” 待 访问 的 端点 
blsLastPacket ”指示 是 否 为 最 后 一 个 数据 包 
该 函数 应 答 从 端点 的 FIFO 中 读 取 的 数据 。 当 参数 blsLastPacket 设置 为 rue 时 ， 数 据 包 
描述 为 端点 0 上 连续 数据 包 中 的 最 后 一 个 。 参 数 blsLastPacket 不 能 用 于 除 端 点 0 外 的 其他 端点 。 
在 需要 处 理 读 取 数据 和 应 答 已 读 取 的 数据 时 ， 可 调用 这 个 函数 
返回 无 
表 工 -11 USBDevEndpointStall 
功能 在 设备 模式 下 停止 指定 的 端点 
void USBDevEndpointStall (uint32_t ui32Base， 
函数 原型 uint32_t ni32Endpoint , 
uint32_t ui32Flags ) 
u32Base 指定 USB 模块 基地 址 
参 数 un32Endpoint ” 待 访问 的 端点 
ui32Flags ”指定 停止 的 是 IN 端点 还 是 OUT 端点 
描述 该 函数 使 端点 号 传递 进入 停止 条 件 。 若 参数 ui32Flags 是 USB_EP_DEV_IN， 则 停止 这 个 端点 
5 的 IN 部 分 。 如果 参 数 ui32Flags 是 USB_EP_DEV_OUT， 则 将 停止 这 个 端点 的 OUT 部 分 
返 回 无 
表 工 -12 USBDevEndpointStallClear 
功能 在 设备 模式 下 清除 指定 端点 上 的 停止 条 件 
void USBDevEndpointStallClear (uint32_t ui32Base, 
函数 原型 uint32_t ui32Endpoint, 
uint32_t ui32Flags ) 
ui32Base 指定 USB 模块 基地 址 
参数 u32Endpoint ” 待 访问 的 端点 
ui32Flags ”指定 要 清除 的 中 止 条 件 是 IN 端点 还 是 OUT 端点 
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( 续 ) 


该 函数 使 端点 号 传递 到 退出 停止 条 件 。 如 果 参 数 ui32Flags 为 USB_EP_DEV_IN， 则 停止 
描述 条 件 将 从 这 个 端点 的 IN 部 分 删除 。 若 参数 ui32Flags 为 USB_EP_DEV_OUT， 则 停止 条 件 将 
从 这 个 端点 的 OUT 部 分 删除 

















返回 无 
表 L-13 USBDevEndpointStatusClear 
功能 在 设备 模式 中 清除 该 端点 的 状态 位 





Void USBDevEndpointStatusClear (uint32_t ui32Base, 
函数 原型 uint32_t mn32Endpoint , 
unt32_t ui32Flags ) 





ui32Base 指定 USB 模块 基地 址 
参 数 un32Endpoint ” 待 访问 的 端点 
ui32Flags ”指定 要 清除 的 中 止 条 件 是 IN 端点 还 是 OUT 端点 








该 函数 可 清除 传递 给 参数 ui32Flags 的 任何 状态 位 。 参 数 ui32Flags 可 获取 调用 USBEnd- 




































































描述 pointStatus( ) 的 返回 值 
返回 无 
表 L-14 USBDevMode 

功能 将 USB 控制 器 的 模式 变更 为 从 机 模式 
函数 原型 void USBDevMode (uint32_t mi32Base ) 
参 数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 将 USB 控制 器 的 模式 改变 成 设备 模式 
返回 无 

表 L-15 USBDevSpeedGet 
功能 返回 在 设备 模式 下 USB 控制 器 的 当前 速度 
函数 原型 uint32_t USBDevSpeedGet (uint32_t ui32Base) 
参数 ui32Base 指定 USB 模块 基地 址 
描述 该 函数 返 问 连接 到 USB 主机 控制 器 的 运 行 速 度 。 这 个 函数 返回 USB_HIGH_SPEED 或 

USB_FULL_SPEED 之 一 来 指示 从 机 模式 下 的 连接 速度 

返回 要 么 返回 USB_HIGH_SPEED， 要 么 返回 USB_FULL_SPEED 























表 L-16 USBEndpointDataAvail 



























































功能 确定 给 定 端点 的 FIFO 中 可 用 的 数据 的 字 节 的 数量 

ーー 四 人 uint32_t USBEndpointDataAvail (uint32_t ui32Base, 

函数 原型 uint32_t ui32Endpoint) 

参数 u32Base 指定 USB 模块 基地 址 

ui32Endpoint ” 待 访问 的 端点 

描述 该 函数 返回 给 定 接收 (OUT) 端点 的 FIFO 中 当前 可 用 数据 的 字 节 数 。 它 可 用 于 先期 调 
Ee USBEndpointDataGet ( ) 来 确定 存放 新 接收 的 数据 包 所 需 缓冲 区 的 大 小 

返回 这 个 调用 返回 给 定 端点 的 FIFO 中 可 用 的 字 节 数 
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表 工 -17 USBEndpointDataGet 






































































































































































































































功能 获取 给 定 端点 FIFO 中 的 数据 
int32_t USBEndpointDataGet (uint32_t ui32 Base , 
ーー kr 電 | uint32_t ui32 Endpoint, 
函数 原型 uint8_t * pui8 Data , 
uint32_t * pui32Size) 
ui32Base 指定 USB 模块 基地 址 
un32Endpoint ” 待 访问 的 端点 
参数 pui8Data ”指向 用 于 从 FIFO 中 返回 数据 的 数据 区 指针 
pui32Size 通过 参数 pui8 Data 传递 给 这 个 调用 的 初始 化 缓冲 区 大 小 。 它 被 设置 为 在 FIFO 
中 返回 的 数据 个 数 
该 函数 返回 给 定 端点 FIFO 中 的 数据 。 参 数 pui32Size 表示 传递 给 参数 pui32Data 的 缓冲 区 
描述 大 小 。 改 变 参 数 pui32Size 中 的 数据 ， 以 匹配 参数 pui8Data 中 返回 数据 的 个 数 。 如 果 接 收 
一 个 0 字 节 的 数据 包 ， 这 个 调用 虽 不 会 返回 一 个 错误 ， 但 会 在 pui32Size 参数 中 返回 一 个 
0。 当 没有 可 用 的 数据 包 时 ， 才 会 产生 唯一 的 错误 情况 
返回 这 个 调用 将 返回 0; 如 果 返 回 -1， 则 没有 收 到 数据 包 
表 L-18 USBEndpointDataPut 
功能 将 数据 存放 到 给 定 端点 的 FIFO 中 
int32_t USBEndpointDataPut (uint32_t ui32Base， 
7 | uint32_t ui32Endpoint, 
函数 原型 uint8_t * pui8Data, 
uint32_t * pui32Size) 
ui32Base 指定 USB 模块 的 基地 址 
参数 ui32Endpoint ” 待 访问 的 端点 
pui8Data ”指向 作为 存放 到 FIFO 中 数据 源 的 数据 区 指针 
pui32Size 返回 存放 到 FIFO 中 的 数据 个 数 
该 函数 把 参数 pui8Data 中 的 数据 存放 到 该 端点 的 FIFO 中 。 如 果 一 个 数据 包 已 经 等 待 传 
描述 输 ， 则 该 调用 不 会 把 任何 数据 存放 到 FIFO 中 ， 并 返回 - 1。 注意 不 能 写 人 超过 USBFIFO- 
ConfigSet( ) 分 配给 FIFO 所 能 保存 的 数据 
返回 返回 0 表示 调用 成 功 ; 返回 -1， 表 示 FIFO 处 于 使 用 中 不 能 写 人 
表 工 -19 USBEndpointDataSend 
功能 始 一 个 端点 的 FIFO 中 的 数据 传输 
int32_t USBEndpointDataSend (uint32_t ui32Base, 
函数 原型 uint32_t ui32Endpoint, 
uint32_t n32TransType ) 
u32Base 指定 USB 模块 的 基地 址 
参数 ui32Endpoint ” 待 访问 的 端点 
ui32TransType ”指示 待 发 送 数 据 的 类 型 
该 函数 开始 一 个 给 定 端点 的 FIFO 数据 传输 。 如 果 该 端点 的 USB_EP_AUTO_SET 位 未 被 
使 能 ， 则 会 调用 这 个 函数 。 设 置 待 请 求 的 事务 类 型 的 参数 ui32TransType 允许 在 USB 总 线 
上 出 现 适当 的 信号 
ui32TransType 参数 必须 为 下 列 值 之 一 : 
描述 > USB_TRANS_OUT // 在 主机 模式 下 任何 端点 的 OUT 事务 
> USB_TRANS_IN // 在 设备 模式 下 任何 端点 的 IN 事务 
> USB_TRANS_IN_LAST ”// 在 IN 事务 序列 中 端点 0 上 的 最 后 IN 事务 
> USB_TRANS_SETUP // 设 置 端点 0 上 的 事务 
> USB_TRANS_STATUS // 端 点 0 的 状态 结果 
返回 返回 0 表示 调用 成 功 ; 如 果 传 输 已 在 进行 中 则 返回 -1 
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表 工 -20 USBEndpointDataToggleClear 





















































































































































功能 将 一 个 端点 上 的 数据 反 转 设置 成 0 
void USBEndpointDataToggleClear (uint32_t ui32Base， 
函数 原型 uint32_t un32Endpoint , 
uint32_t ui32Flags) 
u32Base 指定 USB 模块 的 基地 址 
参数 nm32Endpoint ”指定 端点 复位 数据 反 转 
ui32Flags ”指示 待 访问 的 是 IN 端点 还 是 OUT 端点 
该 函数 用 于 USB 控制 器 清除 一 个 端点 的 数据 反 转 。 该 调用 可 以 用 在 作为 主机 或 从 机 的 控 
制 器 中 ， 但 对 端点 0 无 效 
参数 ui32Flags 必须 为 下 列 值 中 的 一 个 : 
描述 > USB_EP_HOST_OUT 
> USB_EP_HOST_IN 
> USB_EP_DEV_OUT 
> USB_EP_DEV_IN 
返回 无 
表 L-21 USBEndpointDMAChannel 
功能 设置 用 于 给 定 端点 的 DMA 通道 
void USBEndpointDMAChannel (uint32_t m32Base , 
函数 原型 uint32_t ui32Endpoint, 
uint32_t ui32Channel) 
u32Base 指定 USB 模块 的 基地 址 
参数 ui32Endpoint ”指定 返回 哪个 端点 的 FIFO 地 址 
ui32Channel 指定 DMA 通道 使 用 哪个 端点 
该 函数 用 来 配置 给 定 端点 的 DMA 通道。 接收 DMA 通道 只 能 用 于 接收 终端 ， 同 理 ， 发 送 
描述 DMA 通道 也 只 能 用 于 发 送 端点 。 因 此 ，3 个 接收 和 发 送 DMA 通道 可 以 被 映射 到 除 0 之 外 
a 的 任何 端点 。 传 递 到 ui32Channel 中 的 值 即 是 在 udma. h 中 定义 的 UDMA_CHANNEL_USBEP 
* values 的 值 
返回 无 
表 L-22 USBEndpointDMAConfigSet 
功能 配置 DMA 的 端点 设置 
void USBEndpointDMAConfigSet (uint32_t ui32Base, 
函数 原型 uint32_t ui32Endpoint, 
unt32_t ni32Config ) 
ui32Base 指定 USB 模块 的 基地 址 
参 数 ui32 Endpoint 待 访问 的 端点 
ui32Channel 指定 端点 的 配置 选项 
该 函数 配置 一 个 给 定 端点 的 DMA 设置 ， 而 不 改变 已 配置 的 其 他 选项 。 为 了 使 能 DMA 传 
输 ， 在 DMA 传输 之 前 必须 先行 调用 USBEndpointDMAEnable( ) 函数 。 配 置 选项 传递 到 参数 
ui32Config 中 ， 其 值 的 描述 如 下 
描述 下 列 值 之 一 来 指定 方向 : 














> USB_EP_HOST_OUT 或 USB_EP_DEV_IN // 设 置 从 内 存 到 USB 的 控制 器 DMA 
传输 





> USB_EP_HOST_IN 或 USB_EP_DEV_OUT// 设 置 从 USB 控制 器 到 内 存 的 DMA 传输 
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( 续 ) 














下 列 值 之 一 来 指定 模式 : 

> USB_EP_DMA_MODE_0 (default) /设置 通常 用 于 不 跨越 多 个 数据 包 或 当 每 个 数据 包 
需要 中 断 时 的 传输 
> USB_FP_DMA_MODE_1// 设 置 通常 用 于 跨越 多 个 数据 包 和 包 之 间 不 需要 中 断 的 传输 
仅 用 于 USB_EP_HOST_OUT 或 USB_EP_DEV_IN 的 值 

> USB_EP_AUTO_SET// 设 置 当 一 个 完整 的 数据 包 加 载 到 FIFO 时 ， 人 允许 发 送 DMA 传输 
自动 发 送 。 这 需 用 USB_EP_DMA_MODE_1 确保 当 FIFO 已 满 时 将 数据 包 发 送出 去 ， 以 





















































































































































参数 及 DMA 能 发 送 更 多 的 数据 。 
仅 用 于 USB_EP_HOST_IN 或 USB_EP_DEV_OUT 的 値 : 
> USB_EP_AUTO_CLEAR// 设 置 在 接收 时 允许 接收 DMA 传输 自动 应 答 。 这 需 用 usb_ep_ 
dma_mode_1 确保 当 FIFO 被 DMA 传输 清空 时 ， 数 据 包 能 继续 被 接受 和 应 答 
仅 用 于 USB_EP_HOST_IN 的 值 : 
> USB_EP_AUTO_REQUEST 设 置 当 前 次 传输 已 清空 的 FIFO 时 ， 人 允许 接收 DMA 传输 自 
动 发 送 一 个 新 的 IN 事务 请 求 。 这 通常 用 于 与 USB_EP_AUTO_CLEAR 结合 ， 以 便 接收 
DMA 传输 可 以 继续 进行 而 不 中 断 主 处 理 器 
返回 无 
表 L-23 USBEndpointDMADisable 
功能 禁止 给 定 端点 的 DMA 
void USBEndpointDMADisable (uint32_t m32Base , 
函数 原型 uint32_t ui32Endpoint, 
uint32_t ui32Flags ) 
u32Base 指定 USB 模块 的 基地 址 
参数 u32Endpoint ” 待 访问 的 端点 
ui32Flags ”指定 禁止 那个 方向 
描述 该 个 函数 禁止 一 个 给 定 端的 DMA， 以 允许 无 DMA USB 事务 能 正常 产生 中 断 。 参 数 
ui32Flags 必须 为 USB_EP_DEV_IN 或 USB EP DEV_OUT, 而 所 有 其 他 位 将 被 忽略 
返回 无 
表 工 -24 USBEndpointDMAEnable 
功能 使 能 一 个 给 定 端点 的 DMA 
void USBEndpointDMAEnable (uint32_t ui32Base , 
函数 原型 uint32_t un32Endpoint , 
uint32_t ui32Flags ) 
ui32Base 指定 USB 模块 的 基地 址 
参 数 u32Endpoint ” 待 访问 的 端点 
ui32Flags ”在 使 能 DMA 时 指定 使 用 那个 方向 和 那 种 模式 
该 函数 使 能 一 个 给 定 端点 的 DMA， 以 及 根据 参数 ui32Flags 中 的 值 来 配置 其 模式 。 参 数 
描述 ui32Flags 必须 使 USB_EP_DEV_IN 或 USB_EP_DEV_OUT 置 位 。 一 旦 调用 这 个 函数 ， 唯 一 
的 DMA 或 错误 中 断 将 由 USB 控制 器 产生 
返回 无 
表 L-25 USBEndpointPacketCountSet 
功能 设置 在 传输 多 个 批量 包 时 请 求 包 的 个 数 
void USBEndpointPacketCountSet (uint32_t ui32Base， 
函数 原型 uint32_t ni32Endpoint , 





uint32_t ui32Count) 
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u32Base 指定 USB 模块 的 基地 址 
un32Endpoint ” 待 访问 的 端点 
ui32Flags ”请 求 包 个 数 








该 函数 在 使 用 DMA 传输 多 个 批量 数据 包 时 用 于 设置 请 求 连续 批量 包 的 个 数 




















无 


表 L-26 USBEndpointStatus 


返回 端点 的 当前 状态 








函数 原型 


uint32_ t USBEndpointStatus (uint32_t ui32Base, 


uint32_t ui32Endpoint ) 





u32Base 指定 USB 模块 的 基地 址 
un32Endpoint ” 待 访问 的 端点 








该 函数 返回 一 个 给 定 的 端点 的 状态 。 














如 果 必 须要 清除 这 些 状态 位 ， 则 必须 调用 USBDe- 








vEndpointStatusClear( ) 或 USBHostEndpointStatusClear( ) 函数 





下 面 为 主机 模式 下 的 状态 标志 : 


> USB_HOST_IN_PID_ERROR// 在 给 定 端点 上 出 现 PID 错误 





> USB_HOST_IN_ERROR// 使 用 该 
> USB_HOST_IN_FIFO_FULL// 该 I 








SB_HOST_IN_NOT_COMP// 设 备 对 IN 请 求 响应 失败 
SB_HOST_IN_STALL// 収 到 一 介 IN 端点 的 停止 信号 
SB_HOST_IN_DATA_ERROR// 在 同 歩 模式 下 , IN 端点 出現 一 人 CRC 或 位 填充 错误 
SB_HOST_IN_NAK_TO// 移 IN 端点 接收 到 的 NAK 时 间 超 过 了 指定 的 超时 周期 





IN 端点 与 一 个 设备 通信 失败 
N 端点 的 FIFO 已 满 





> USB_HOST_IN_PKTRDY// 该 IN 端点 的 数据 包 已 准备 就 绪 


> USB_HOST_OUT_NAK_TO// 该 0 


UT 端点 接收 到 的 NAK 时 间 超过 了 指定 的 超时 周期 


> USB_HOST_OUT_NOT_COMP// 役 各 対 OUT 请 求 响应 失败 

> USB_HOST_OUT_STALL// 该 输 OUT 端点 上 收 到 一 个 停止 信和 号 

> USB_HOST_OUT_ERROR// 使 用 该 0UT 端点 与 一 个 设备 通信 失败 
> USB_HOST_OUT_FIFO_NE// 该 端点 的 输出 FIFO 为 非 空 

> USB_HOST_OUT_PKTPEND// 该 OUT 端点 的 数据 传输 没有 完成 





> USB_HOST_EPO_NAK_TO// 端 点 








0 接收 到 的 NAK 时 间 超 过 了 指定 的 超时 周期 





> USB_HOST_EP0_ERROR// 设 备 响 应 端点 0 的 请 求 失败 
> USB_HOST_EPO_IN_STALL// 在 一 次 IN 传输 中 ， 端 点 0 收 到 一 个 停止 信号 
> USB_HOST_EP0_IN_PKTRDY// 端 点 0 上 的 数据 包 已 为 一 次 IN 传输 准备 就 绪 





下 面 为 设备 模式 下 的 状态 标志 : 

















> USB_DEV_OUT_SENT_STALL// 该 OUT 端点 发 送 了 一 个 停止 信号 
> USB_DEV_OUT_DATA_ERROR// 在 一 介 OUT 端点 上 出 现 了 一 个 CRC 或 位 填充 错误 


> USB_DEV_OUT_OVERRUN// 由 ヨ 





F FIFO 已 满 ， 使 输出 包 无 法 加 载 








> USB_DEV_OUT_FIFO_FULL// OUT 端点 的 FIFO 已 满 


> USB_DEV_OUT_PKTRDY// OUT 
> USB_DEV_IN_NOT_COMP/ 一 全 
SB_DEV_IN_SENT_STALL// 在 





SB_DEV_EPO_SETUP_END// 在 








端点 的 FIFO 中 有 一 个 准备 就 绪 的 数据 包 
较 大 的 包 已 被 拆 分 ， 使 更 多 的 数据 传人 
该 IN 端点 上 发 送 一 个 停止 信号 








SB_DEV_IN_UNDERRUN// 在 该 IN 端点 上 请 求 数据 并 且 无 数据 准备 好 
SB_DEV_IN_FIFO_NE// IN 端点 的 FIFO 非 空 
SB_DEV_IN_PKTPEND// 该 IN 端点 的 数据 传输 还 未 完成 











发 送 数 据 结 束 条 件 前 ， 一 个 控制 传输 已 结束 





SB_DEV_EP0_SENT_STALL// 端 点 0 上 发 送 了 一 个 停止 信号 
SB_DEV_EPO_IN_PKTPEND// 端 点 0 上 的 数据 传输 还 未 完成 
SB_DEV_EPO_OUT_PKTRDY// 在 端点 0 上 的 输出 FIFO 有 一 个 数据 包 已 准备 就 绪 











取决 于 模式 的 端点 当前 状态 标志 
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表 L-27 USBFIFOAddrGet 









































































































































功能 返回 一 个 给 定 端点 的 绝对 FIFO 地 址 
る 7 本 電 uint32_t USBFIFOAddrGet (uint32_t ui32 Base , 
函数 原型 uint32_t ui32 Endpoint ) 
参数 ui32Base 指定 USB 模块 的 基地 址 
wm32Endpoint ”指定 待 返回 的 端点 的 FIFO 地 址 
描述 该 函数 返回 FIFO 的 实际 物理 地 址 。USB 需要 该 地 址 来 进行 LDMA 操作 ， 并 且 源 地 址 或 
目标 地 址 也 必须 设置 成 一 个 给 定 端点 的 物理 FIFO 地 址 
返回 无 
表 工 -28 USBFIFOConfigGet 
功能 返回 端点 的 FIFO 配置 
void USBFIFOConfigGet (uint32_t ui32Base, 
uint32_t ui32Endpoint, 
函数 原型 uint32_t * pui32FIFOAddress, 
uint32_t * pui32FIFOSize , 
uint32_t ui32Flags ) 
ui32Base 指定 USB 模块 的 基地 址 
ui32Endpoint ” 待 访问 的 端点 
参数 pui32FIFOAddress FIFO 的 起 始 地 址 
pui32FIFOSize 由 USB_FIFO_SZ_ values 的 值 之 一 来 指定 FIFO 的 大 小 
ui32Flags 指定 从 FIFO 配置 中 获取 的 信息 
该 函数 返回 一 个 给 定 端点 FIFO 的 起 始 地 址 和 大 小 。 由 于 端点 0 不 能 动态 配置 FIFO， 所 
以 该 函数 不 能 被 端点 0 调用 
描述 参数 ui32Flags 指定 读 取 端点 为 OUT FIFO 和 IN FIFO 之 一 。 如 果 在 主机 模式 下 ， 
ui32Flags 参数 为 USB_EP_HOST_OUT 或 USB_EP_HOST_IN; 如 果 在 设备 模式 下 ， 则 
ui32Flags 参数 必须 为 USB_EP_DEV_OUT 或 USB_EP_DEV_IN 
返回 无 
表 L-29 USBFIFOConfigSet 
功能 设置 端点 的 FIFO 配置 
void USBFIFOConfigSet (uint32_t ui32Base, 
uint32_t ui32Endpoint, 
函数 原型 uint32_t ui32FIFOA ddress, 
uint32_t u32FIFOSize, 
uint32_t ui32Flags) 
ui32Base 指定 USB 模块 的 基地 址 
un32Endpoint 待 访 问 的 端点 
参 数 pui32FIFOAddress FIFO 的 起 始 地址 
pui32FIFOSize 由 USB_FIFO_SZ_values 中 的 值 之 一 来 指定 FIFO 的 大 小 
ui32Flags 指定 从 FIFO 配置 中 获取 的 信息 
该 函数 配置 一 个 给 定 端点 的 起 始 FIFO RAM 地 址 和 FIFO 大 小 。 由 于 端点 0 不 能 动态 配 
置 FIFO， 所 以 该 函数 不 能 被 端点 0 週 用 。 参 数 32FIFOSize 必须 为 USB_FIFO_SZ_values 中 
的 值 之 一 
描述 ui32FIFOAddress 的 值 必须 是 8 字 节 的 倍数 ， 并 直接 表示 USB 控制 器 FIFO RAM 中 的 起 始 
田代 地 址 
参数 ui32Flags 指定 读 取 端点 为 OUT FIFO 和 IN FIFO 之 一 。 如 果 在 主机 模式 下 ， 
ui32Flags 参数 为 USB_EP_HOST_OUT 或 USB_EP_HOST_IN: 如 果 在 设备 模式 下 ， 则 
ui32Flags 参数 必须 为 USB_EP_DEV_OUT 或 USB_EP_DEV_IN 
返回 无 
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表 L-30 USBFIFOFlush 



































































































































功能 强制 刷新 端点 的 FIFO 
void USBFIFOFlush (uint32_t ui32Base, 
函数 原型 uint32_t un32Endpoint , 
uint32_t ui32Flags ) 
u32Base 指定 USB 模块 的 基地 址 
参 数 RU: 待 访问 的 端点 
ui32Flags ”指定 待 访问 的 是 IN 端点 ， 还 是 OUT 端点 
函数 强制 刷新 USB 控制 器 FIFO 中 的 数据 。 该 函数 既 可 被 主机 调用 ， 也 可 以 被 设备 控 
和 器 (从 机 ) 所 调用 。 
参 数 ui32Flags 的 取 值 为 下 值 之 一 : 
描述 > USB_EP_HOST_IN 
> USB_EP_HOST_OUT 
> USB_EP_DEV_OUT 
> USB_EP_DEV_IN 
返回 无 
表 L-31 USBFrameNumberGet 
功能 获取 当前 帧 号 
函数 原型 uint32_t USBFrameNumberGet (uint32_t ui32Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
描述 该 函数 返回 接收 到 的 最 后 一 帧 的 帧 号 
返回 收 到 的 最 后 一 帧 号 的 帧 号 
表 L-32 USBHighSpeed 
功能 使 能 或 禁止 USB 高 速 协商 ( negotiation ) 
函数 原型 void USBHighSpeed (uint32_t ui32Base , bool bEnable ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
bEnable 指定 是 使 能 高 速 协 商 还 是 禁止 高 速 协商 
当 调 用 函数 的 参数 bEnable 设置 为 hue 时 ， 均 可 使 能 主机 和 设备 模式 的 高 速 协商 。 在 设 
描述 备 模式 下 当 USB 控制 器 从 主机 接收 一 个 复位 信号 时 会 引起 设备 的 高 速 协商 。 在 主机 模式 下 
人 当 所 连接 设备 复位 时 USB 主机 将 使 能 高 速 协商 。 如 果 bEnable 设置 为 false 控制 器 只 在 全 速 
或 低速 下 运行 
返回 返回 端点 当前 正在 使 用 的 功能 地 址 
表 L-33 USBHostAddrGet 
功能 获取 端点 当前 功能 设备 的 地 址 
uint32_t USBHostAddrGet (uint32_t ui32Base, 
函数 原型 uint32_t ni32Endpoint , 
unt32_t ui32Flags ) 
ui32Base 指定 USB 模块 的 基地 址 
参数 ui32Endpoint ” 待 访问 的 端点 
ui32Flags ”确定 是 IN 端点 ， 还 是 OUT 端点 
描述 该 函数 返回 与 设备 通信 端点 的 功能 地 址 。 参 数 ui32Flags 确定 是 返回 IN 端点 的 设备 地 址 ， 
二 还 是 返回 OUT 端点 的 设备 地 址 
返回 返回 当前 正在 使 用 端点 的 功能 地 址 
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功能 


表 L-34 USBHostAddrSet 
设置 在 主机 模式 下 连接 到 一 个 端点 设备 的 功能 地 址 








函数 原型 


void USBHostAddrSet (uint32_t ui32Base, 
uint32_t ui32Endpoint, 
uint32_t ui32 Addr, 
uint32_t ui32Flags ) 





ui32 Base 


指定 USB 模块 的 基地 址 


ui32Endpoint ”等 访问 的 端点 


ui32Addr 
ui32 Flags 





控制 器 使 用 该 端点 的 功能 地 址 
确定 是 IN 端点 ， 还 是 OU 





T 端点 





该 函数 配置 使 
的 目标 设备 的 地 
























































该 端点 进行 通信 设备 的 功能 地 址 。 参 数 ui32Addr 是 与 这 个 端点 进行 通信 
此 。 参 数 ui32Flags 指示 是 要 设置 IN 端点 ， 还 是 OUT 端点 








功能 


无 


表 L-35 USBHostEndpointConfig 
设置 主机 端点 的 基本 配置 





函数 原型 


void USBHostEndpointConfig (uint32_t ui32Base, 

uint32_t ui32Endpoint, 
uint32_t ui32MaxPayload , 
uint32_t ui32NAKPollInterval , 
unt32_t nm32TargetEndpoint , 
uint32_t ui32Flags ) 





ui32 Base 


旨 定 USB 模块 的 基地 址 


u32Endpoint ” 待 访问 的 端点 


ui32MaxPayload ”该 端点 的 最 大 有 效 载 丛 
根据 端点 类 型 的 NAK 超时 限制 或 轮 询 间隔 
主机 端点 的 目标 端点 


ui32NAKPollInterval 
ui32TargetEndpoint 


ui32Flags 








用 于 配置 其 他 端点 设置 














该 函数 设置 主机 模式 中 的 一 个 端点 发 送 或 接收 部 分 的 基本 配置 。 参 数 ui32Flags 确定 一 
些 配置 而 剩余 的 配置 可 由 其 他 参数 给 出 。 参 数 ui32Flags 决定 是 一 个 IN 端点 (USB_EP_ 


HOST _IN 或 USB_EP_DEV_IN) ， 还 是 0UT 的 端点 (USB_EP_HOST_OUT 或 USB_EP_DEV 























OUT) 。 并 且 决 定 是 一 个 全 速 端点 (USB_EP_SPEED_FULL) ， 还 是 低速 (USB_EP_SPEED_ 


LOW) 端点 
USB_EP_MODE_flags 控制 端点 的 类 型 : 
> USB_EP_MODE_CTRL 
> USB_EP_MODE_ISOC 
> USB_EP_MODE_BULK 
> USB_EP_MODE_INT 
根据 USB_EP_MODE 的 値 和 端点 0 

ui32NAKPollInterval 的 含义 不 同 。 对 村 

允许 设备 NAK 的 帧 数 。 如 果 是 同步 端点 或 了 
对 于 中 断 端 点 ， 轮 询 间 








// 控 制 端点 
// 等 时 端点 
// 批 量 端点 
// 中 断 端点 


FP 断 端点 ， 则 该 值 为 这 个 





隔 为 端点 IN 请 求 





及 另外 的 端点 是 否 调 月 





有 该 函数 ， 将 使 参数 





F 端点 0 或 批量 端点 ， 该 值 总 是 表示 在 认为 超时 之 前 
端点 的 轮 询 间 隔 
P 断 之 间 的 帧 数 且 其 范围 为 1 ~255。 对 于 同步 





端点 ， 此 值 表示 轮 询 间隔 为 2” (ui32NAKPollmterval - 1) 的 帧 。 在 用 于 NAK 超时 ， 


ui32NAKPollInterval 的 值 在 发 布 一 个 超时 前 被 
当 设 置 ui32nakpollinterval 值 














首 定 为 2^ (ui32NAKPollInterval - 1) 的 帧 
时 ， 可 指定 两 个 特殊 的 超时 值 。 其 一 为 MAX_NAK_LIMIT, 





它 是 传递 给 该 变量 的 最 大 值 ; 其 二 为 DISABLE_NAK_LIMIT， 它 表明 没有 NAK 的 数量 限制 








取决 于 如 何 配置 DMA 控制 器 及 其 用 途 





USB_EP_DMA_MODE_flags 使 能 DMA 类 型 用 来 访问 端点 的 数据 FIFO。DMA 的 模式 选择 
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( 续 ) 



































在 配置 端点 的 OUT 部 分 时 ， 当 由 ui32MaxPayload 指定 的 字 节 数 一 经 写 人 到 该 端点 的 OUT 
FIFO 中 时 ， 则 可 指定 USB_EP_AUTO_SET 位 来 启动 USB 总 线 上 的 数据 传输 
在 配置 端点 的 IN 部 分 时 ， 一 且 TFIFO 腾 出 足够 的 空间 以 适应 ui32MaxPayload 字 节 , 可 指 
描述 定 USB_EP_AUTO_REQUEST 位 以 触发 更 多 的 数据 请 求 。 一 旦 从 FIFO 中 读 取 数 据 完 成 ， 可 
USB_EP_AUTO_CLEAR 位 来 自动 清除 数据 包 的 准备 就 绪 标 志 。 如 果 不 使 用 此 选项 ， 则 























必须 通过 调用 USBDevEndpointStatusClear( ) 或 USBHostEndpointStatusClear( ) 函数 来 手工 清 
除 该 标志 








岗 
回 





无 


表 工 -36 USBHostEndpointDataAck 
功能 在 主机 模式 下 对 从 给 定 端点 FIFO 中 读 取 数 据 的 应 答 














void USBHostEndpointDataAck (uint32_t ui32Base, 
uint32_t ui32Endpoint) 





参数 u32Base 指定 USB 模块 的 基地 址 
u32Endpoint ” 待 访问 的 端点 








该 函数 为 从 端点 的 FIFO 中 读 取 数据 的 应 答 。 如 果 需 要 在 读 取 数据 与 应 答 已 读 取 的 数据 


























述 i El EE NN 
J 之 间 进 行 处 理 ， 需 调用 这 个 函数 
返回 无 
表 L-37 USBHostEndpointDataToggle 

功能 在 主机 模式 下 设置 端点 的 翻转 数据 值 

Void USBHostEndpointDataToggle (uint32_t ui32Base, 
| uint32_t un32Endpoint , 
函数 原型 bool bDataToggle, 

uint32_t ui32Flags ) 

ui32Base 指定 USB 模块 的 基地 址 

参数 u32Endpoint ”指定 复位 数据 翻转 的 端点 


bDataToggle ”指定 状态 是 设置 为 DATA0， 还 是 DATA1 
ui32Flags 指定 是 IN 端点 ， 还 是 OUT 端点 




















该 函数 用 于 在 主机 模式 下 强制 数据 状态 的 翻转 。 如 果 传 递 给 参数 bDataToggle 的 值 为 false， 则 
描述 数据 翻转 设置 为 DATAO 状态 ， 若 为 rue， 则 成 DATA1 状态 。 参 数 ui32Flags 可 为 USB_EP_HOST 
_IN 或 USB_EP_HOST_OUT 用 于 分 别 访问 该 端点 所 需 的 部 分 。 而 端点 0 忽略 ui32Flags 参数 











返回 无 





表 L-38 USBHostEndpointPing 
功能 在 主机 模式 下 对 于 使 用 高 速 控 制 传输 的 端点 使 能 或 禁止 ping 令 牌 




















void USBHostEndpointPing (uint32_t ui32Base, 
函数 原型 uint32_t un32Endpoint , 
bool bEnable ) 





u32Base 指定 USB 模块 的 基地 址 
参数 u32Endpoint ”指定 是 使 能 还 是 禁止 ping 令 牌 的 端点 
bEnable 指定 是 使 能 还 是 禁止 ping 令 牌 























该 函数 在 数据 和 状态 阶段 的 高 速 控制 传输 期 间 用 于 配置 USB 控制 器 以 发 送 或 者 不 发 送 
ping 令 牌 。ui32Endpoint 仅 支 持 USB_EP_0， 因 为 处 理 所 有 的 控制 传输 都 使 用 这 个 端点 。 如 



































描述 果 bEnable 为 真 ， 则 使 能 ping 令 牌 ， 如 果 bEnable 为 false， 则 禁止 ping 令 牌 。 不 支持 设备 
在 使 用 高 速 模式 时 ping 信 
返回 无 
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表 L-39 USBHostEndpointSpeed 
功能 更 改 主机 端点 连接 的 速度 





void USBHostEndpointSpeed (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Endpoint, 
uint32_t ui32Flags) 





u32Base 指定 USB 模块 的 基地 址 
un32Endpoint ” 待 访问 的 端点 
u32Flags ”用 于 配置 其 他 端点 的 设置 


Wp 
洋 





























该 函数 用 于 在 主机 模式 下 设置 IN 或 OUT 端点 的 USB 速度 。 参 数 ui32Flags 可 使 用 下 列 值 
之 一 来 指定 速度 : 

> USB_EP_ SPEED_LOW 

描述 > USB_EP_SPEED_FULL 

> USB_EP_ SPEED_HIGH 

参数 32Flags 还 可 通过 添加 USB_EP_HOST_IN 或 USB_EP_HOST_OUT 的 逻辑 或 来 指定 




















方向 的 设置 
返回 无 
表 工 -40 USBHostEndpointStatusClear 
功能 清除 在 主机 模式 下 该 端点 的 状态 位 





void USBHostEndpointStatusClear (uint32_t ui32Base, 
函数 原型 uint32_t ni32Endpoint , 
uint32_t ui32 Flags ) 





ui32Base 指定 USB 模块 的 基地 址 
参数 um32Endpoint ” 待 访问 的 端点 
ui32Flags” 待 清除 的 状态 位 












































AN 该 函数 清除 传递 给 参数 ui32Flags 任何 位 的 状态 。 人 参数 ui32Flags 为 USBEndpointStatus( ) 
描述 i 
调用 的 返回 值 
返回 无 
表 L-41 USBHostHubAddrGet 
功能 获取 该 端点 当前 设备 的 HUB (集线器) 地 址 








uint32 t USBHostHubAddrGet ( uint32_t ui32Base， 
函数 原型 uint32_t ui32Endpoint, 
uint32_t ui32Flags ) 





ui32Base 指定 USB 模块 的 基地 址 
参数 um32Endpoint ” 待 访问 的 端点 
ui32Flags ”确定 是 IN 端点 ， 还 是 OUT 端点 





























该 函数 返回 当前 正在 使 用 的 与 设备 通信 端点 的 HUB 地 址 。 参 数 ui32Flags 决定 返回 的 是 
描述 IN 端点 的 设备 地 址 ， 还 是 OUT 端点 的 设备 地 址 
注意 : 这 个 函数 只 能 在 主机 模式 下 调用 

















返回 该 函数 返回 当前 正在 使 用 的 一 个 端点 的 HUB 地 址 
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表 L-42 USBHostHubAddrSet 








































































































































































































































































































功能 设置 连接 到 一 个 端点 的 设备 HUB 地 址 
void USBHostHubAddrSet (uint32_t ui32Base, 
ーー uint32_t ui32Endpoint, 
函数 原型 uint32_t ui32Addr, 
uint32_t ui32Flags) 
ui32Base 指定 USB 模块 的 基地 址 
un32Endpoint ” 待 访 问 的 端点 
参数 ui32Addr 使 用 该 端点 的 设备 HUB 地 址 和 端口 ， 且 必须 用 0 ~6 位 定义 HUB 地 址 ， 而 用 
8 ~14 位 定义 端口 号 
ui32Flags ”确定 是 IN 端点 ， 还 是 OUT 端点 
该 函数 配置 与 正在 使 用 的 端点 进行 通信 设备 的 HUB 地 址 。 参 数 ui32Flags 决定 这 个 调用 是 配置 
描述 IN 端点 的 设备 地 址 ， 还 是 配置 OUT 端点 的 设备 地 址 ， 并 设置 下 游 设备 的 速度 。 有 效 的 值 为 USB 
_EP_HOST_OUT 或 USB_EP_HOST_IN 其 中 之 一 个 与 USB_EP_SPEED_LOW 的 “或 运算 ” 
返回 无 
表 L-43 USBHostMode 
功能 变更 USB 控制 器 到 主机 的 模式 
函数 原型 void USBHostMode (uint32_t un32Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
描述 该 函数 将 把 USB 控制 器 模式 改变 为 主机 模式 
返回 无 
表 L-44 USBHostPwrConfig 
功能 设置 USB 电源 故障 的 配置 
吉 半 | 百 开 | void USBHostPwrConfig (uint32_t ui32Base, 
函数 原型 uint32_t ui32 Flags ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
ui32Flags ”指定 电源 故障 的 配置 
该 函数 控制 USB 控制 器 如 何 使 用 它 的 外 部 电源 控制 的 引 脚 (USBnPFLT、 USBnEPEN ) 。 
标志 用 来 指定 电源 故障 电 平 的 灵敏 度 、 电 源 故 障 动作 ， 电 源 使 能 电 平和 来 源 
可 选择 下 列 其 中 一 种 作为 电源 故障 的 电 平 灵敏 度 : 
> USB_HOST_PWRFLT_LOW// 拉 低 引 脚 电 平 来 指示 外 部 电源 故障 
> USB_HOST_PWRFLT_HIGH// 拉 高 引 脚 电 平 来 指示 外 部 电源 故障 
可 选择 下 列 其 中 的 一 种 作为 电源 故障 的 动作 : 
> USB_HOST_PWRFLT_EP_NONE// 当 检测 到 电源 故障 时 无 自动 操作 
> USB_HOST_PWRFLT_EP_TRI// 当 电源 故障 时 USBnEPEN 引 脚 将 自动 变 成 三 态 
> USB_HOST_PWRFLT_EP_LOW// 在 电源 故障 时 USBnEPEN 引 肢 将 自动 被 驱动 为 低 电 平 
> USB_HOST_PWRFLT_EP_HIGH// 在 电源 故障 时 USBnEPEN 引 脚 将 自动 被 驱动 为 高 电 平 
描述 可 选择 下 列 操作 中 的 一 种 作为 电源 的 等 级 使 能 和 来 源 : 
Mae > USB_HOST_PWREN_MAN_LOW// 当 调用 USBHostPwrEnable( ) 時 。 USBnEPEN 引 脚 将 
由 USB 控制 器 驱动 为 低 电 平 
> USB_HOST_PWREN_MAN_HIGH// 当 调用 USBHostPwrEnable( ) 时 ，USBnEPEN 引 脚 将 
由 USB 控制 器 驱动 为 高 电 平 
> USB_HOST_PWREN_AUTOLOW// 如 果 USBOTGSessionRequest( ) 已 启用 了 会 话 ，USB- 
nEPEN 引 脚 将 由 USB 控制 器 自动 驱动 为 低 电 平 
> USB_HOST_PWREN_AUTOHIGH// 如果 USBOTGSessionRequest( ) 已 启用 了 会 话 ，USB- 
nEPEN 引 脚 将 由 USB 控制 器 自动 驱动 为 高 电 平 
在 支持 VBUS 故障 滤波 器 的 设备 上 ， 可 以 添加 USB_HOST_PWREN_FILTER 来 消除 由 高 
功 耗 引起 的 小 的 、 短 促 的 VBUS 电 平 下 降 。 此 特性 主要 用 于 避免 由 于 设备 的 高 浪 涌 电 流 造 
成 的 VBUS 错误 
返回 无 
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表 工 -45 USBHostPwrDisable 





























功能 禁止 外 部 电源 引 脚 

函数 原型 void USBHostPwrDisable (uint32_t mi32Base ) 

参 数 ui32Base 指定 USB 模块 的 基地 址 

描述 该 函数 禁止 USBnEPEN 信号 ， 禁 止 外 部 电源 在 主机 模式 中 操作 
返回 无 








表 工 -46 USBHostPwrEnable 




















功能 使 能 外 部 电源 引 脚 

函数 原型 void USBHostPwrEnable (uint32_t ni32Base ) 

参 数 u32Base 指定 USB 模块 的 基地 址 

描述 该 函数 使 能 USBnEPEN 信号 ， 使 能 外 部 电源 在 主机 模式 中 操作 
返回 无 








表 L-47 USBHostPwrFaultDisable 














功能 禁止 电源 故障 检测 

函数 原型 void USBHostPwrFaultDisable (uint32_t mi32Base ) 
参 数 u32Base 指定 USB 模块 的 基地 址 。 

描述 该 函数 禁止 USB 控制 器 的 电源 故障 检测 

返回 无 


表 工 -48 USBHostPwrEaultEnable 





























功能 使 能 电源 故障 检测 

函数 原型 void USBHostPwrFaultEnable (uint32_t ui32 Base ) 

参数 u32Base 指定 USB 模块 的 基地 址 

描述 该 函数 使 能 USB 控制 器 中 的 电源 故障 检测 。 如 果 在 USBnPFLT 引 脚 不 使 用 时 ， 该 函数 不 
es 能 被 使 用 

返回 无 





表 L-49 USBHostRequestIN 
功能 在 主机 模式 中 预定 一 个 端点 上 的 IN 事务 请 求 





jin 

















void USBHostRequestIN (uint32_t ui32 Base , 





























Ey 型 
函数 原型 uint32_t ui32Endpoint) 
参数 ui32Base 指定 USB 模块 的 基地 址 
u32Endpoint ” 待 访问 的 端点 
描述 该 函数 预定 一 个 IN 事务 请 求 。 在 通信 的 USB 设备 响应 数据 时 ， 可 以 通过 调用 USBEnd- 
le pointDataGet( ) 或 通过 DMA 传输 来 获取 数据 
返回 无 
表 L-50 USBHostRequestINClear 
功能 清除 主机 模式 中 端点 的 一 个 预定 IN 事务 
函数 原型 void USBHostRequestINClear (uint32_t ui32Base, 





uint32_t ui32Endpoint ) 
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( 续 ) 
ui32Base 指定 USB 模块 的 基地 址 






























































































































































































































































































































































会 六 
参数 ui32Endpoint ” 待 访问 的 端点 
描述 如 果 当 前 仍 被 挂 起 ,该 函数 用 于 清除 之 前 预定 的 IN 事务 。 如 果 由 ui32Endpoint 指定 的 端 
0 点 被 重新 配置 成 与 其 他 设备 进行 通信 ， 该 函数 被 用 来 安全 地 禁用 任何 预定 IN 事务 
返回 无 
表 L-51 USBHostRequestStatus 
功能 在 端点 0 上 发 布 一 个 状态 IN 事务 请 求 
函数 原型 void USBHostRequestStatus (uint32_t ui32 Base ) 
参 数 u32Base 指定 USB 模块 的 基地 址 
该 函数 用 来 发 布 端点 0 上 设备 的 状态 IN 事务 请 求 。 该 函数 只 能 与 端点 0 一 起 使 用 ， 这 
描述 是 因为 只 有 控制 端点 支持 这 种 功能 。 此 函数 用 于 完成 一 个 设备 最 后 阶段 的 控制 事务 且 当 收 
到 状态 数据 包 时 会 发 出 一 个 中 断 信号 
返回 无 
表 L-52 USBHostReset 
功能 处 理 USB 总 线 的 复位 条 件 
画数 原型 void USBHostReset (uint32_t m32 Base , 
bool bStart ) 
参 数 u32Base 指定 USB 模块 的 基地 址 
bStart ”指定 在 USB 总 线 上 发 出 的 是 启动 复位 信号 ， 还 是 停止 复位 信号 
描述 在 该 函数 被 调用 是 参数 bStart 设置 为 ue 时 ， 该 函数 将 启动 USB 总 线 上 的 复位 条 件 。 调 
be 者 必须 延迟 20ms 以 上 才能 再 次 调用 参数 bStat 设置 为 false 的 画数 
返回 无 
表 L-53 USBHostResume 
功能 处 理 USB 总 线 的 恢复 条 件 
函数 原型 void USBHostResume (uint32_t ui32Base, 
bool bStart) 
参数 u32Base 指定 USB 模块 的 基地 址 
本 bStart ”指定 USB 控制 器 是 进入 恢复 信号 状态 ， 还 是 离开 恢复 信号 状态 
在 设备 模式 时 ， 该 函数 使 USB 控制 器 脱离 挂 起 状态 。 此 调用 必须 先 把 参数 bStart 设置 为 
true 来 启动 恢复 信和 号。 然后 ， 在 设备 应 用 程序 必须 延迟 至 少 10ms 但 不 超过 15 ms 后 ， 方 可 
调用 参数 bStart 设置 为 false 的 函数 ( ) 。 
描述 在 主机 模式 时 ， 这 个 函数 发 出 设备 离开 挂 起 状态 的 信号 。 此 调用 必须 先 把 参数 bStart 设 
置 为 rue 来 启动 恢复 信号 。 然 后 ， 在 主机 应 用 程序 必须 延迟 至 少 20ms 后 ， 才 可 调用 参数 
bStart 设置 为 false 的 函数 ( ) 
这 个 操作 将 使 控制 器 完成 在 USB 总 线 上 的 恢复 信号 
返回 无 
表 L-54 USBHostSpeedGet 
功能 返回 当前 被 连接 的 USB 设备 的 速度 
函数 原型 uint32_t USBHostSpeedCet (uint32_t ui32Base) 
参数 ui32Base 指定 USB 模块 的 基地 址 
描述 该 函数 返回 在 主机 模式 中 当前 USB 总 线 的 速度 
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返回 下 列 值 之 一 : 
返回 > USB_LOW_SPEED 
> USB_FULL_SPEED 
> USB_UNDEF_SPEED 
表 L-55 USBHostSuspend 
功能 使 USB 总 线 处 于 挂 起 状态 
函数 原型 void USBHostSuspend (uint32_t ui32 Base ) 
参 数 u32Base 指定 USB 模块 的 基地 址 
描述 在 使 用 主机 模式 时 ， 该 函数 使 USB 总 线 处 于 挂 起 状态 
返回 无 
表 L-56 USBIntDisableControl 
功能 禁止 给 定 USB 控制 器 上 的 控制 中 断 
7 下 弄 | void USBIntDisableControl (uint32_t ui32Base , 
函数 原型 uint32_t ui32Flags) 
参数 ui32Base 指定 USB 模块 的 基地 址 
ui32Flags ”指定 要 禁止 的 控制 中 断 
该 函数 禁止 由 参数 ui32Base 指定 的 USB 控制 器 的 控制 中 断 。 参 数 ui32Flags 指定 要 禁止 
描述 的 控制 中 断 。 传 递 到 ui32Flags 参数 中 的 标志 必须 定义 为 以 USB_INTCTRL_ * 开始 ， 而 不 
是 任何 其 他 的 USB_INT 标志 
返回 无 
表 L-57 USBIntDisableEndpoint 
功能 禁止 给 定 USB 控制 咒 上 的 端点 中 断 
| void USBIntDisableEndpoint (uint32_t m32Base , 
函数 原型 uint32_t ui32Flags ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
ui32Flags ”指定 要 禁止 的 端点 中 断 
该 函数 禁止 由 参数 ui32Base 指定 的 USB 控制 器 的 端点 中 断 。 参 数 ui32Flags 指定 要 禁止 
描述 的 端点 中 断 。 传 弟 到 ui32Flags 参数 中 的 标志 必须 定义 为 以 USB_INTEP__* 开始 ， 而 不 是 
任何 其 他 的 USB_INT 标志 
返回 无 
表 L-58 USBIntEnableControl 
功能 使 能 给 定 USB 控制 器 上 的 控制 中 断 
7 | void USBIntEnableControl ( uint32_t ui32 Base , 
西数 原型 uint32_t ui32 Flags ) 
参数 ui32Base 指定 USB 模块 的 基地 址 
= ui32Flags 指定 要 使 能 的 控 制 中 断 
描述 该 函数 使 能 由 参数 ui32Base 指定 的 USB 控制 器 的 控制 中 断 。 参 数 m32Flags 指定 要 使 能 
的 控制 中 断 
返回 无 
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功 外 


能 


表 L-59 USBIntEnableEndpoint 
使 能 给 定 USB 控制 器 上 的 端点 中 断 








加 


数 原 型 


void USBIntEnableEndpoint (uint32_t ui32Base, 
uint32_t ui32Flags ) 





u32Base 指定 USB 模块 的 基地 址 
u32Flags 指定 要 使 能 的 端点 中 断 











该 函数 使 能 由 参数 ui32Base 指定 的 USB 控制 器 的 端点 中 断 。 参 数 32Flags 指定 要 使 能 
的 端点 中 断 











无 


表 L-60 USBIntRegister 
注册 USB 控制 器 的 中 断 处 理 程序 








void USBIntRegister (uint32_t ui32Base, 
void ( * pfnHandler) (void)) 





u32Base 指定 USB 模块 的 基地 址 
pfnHandler 当 USB 中 断 发 生 时 指向 被 调用 函数 的 指针 




















该 函数 用 于 在 USB 中 断 发 生 时 注册 被 调用 的 处 理 程序 ， 并 使 能 中 断 控 制 器 中 的 USB 全 
局 中 断 。 必 须 通过 单独 调用 USBIntEnable( ) 函数 来 使 能 指定 所 需 的 USB 中 断 。 由 中 断 处 理 
程序 负责 调用 USBIntStatusControl( ) 和 USBIntStatnsEndpoint( ) 函数 来 清除 中 断 源 
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表 工 -61 USBIntStatusControl 
返回 给 定 USB 控制 器 上 的 控制 中 断 状态 


互 








加 


数 原 型 


uint32_t USBIntStatusControl (uint32_t ui32Base ) 





る 


数 


ui32Base 指定 USB 模块 的 基地 址 





总 











该 函数 读 取 一 个 USB 控制 器 的 控制 中 断 状态 。 这 个 调用 仅 返 回 控制 中 断 的 当前 状态 ， 端 
点 中 断 状态 可 通过 调用 USBIntStatusEndpoint( ) 来 获取 。 返 回 的 位 值 与 USB_INCTRL_* 值 
比较 

以 下 是 所 有 USB_INCTRL 标志 的 含义 及 其 有 效 模式 。 这 些 值 适 用 于 对 任何 USBIntEna- 
bleControl( ) 、USBIntStatusControl( ) 和 USBIntDisableControl( ) 的 调用 。 在 下 列 模式 中 这 些 
标志 的 唯一 有 效 形式 在 括号 中 注 明 : Host、Device 、OTG 

> USB_INTCTRL_ALL// 扉 蔽 所 有 控 制 中 断 源 

> USB_INTCTRL VBUS_ERR// 发 生 VBUS 错误 (公主 机 ) 

> USB_INTCTRL_ SESSION 在 电缆 A 侧 上 的 会 话 开 始 检测 ( 仅 OTC) 

> USB_INTCTRL_SESSION_END// 会 话 结束 检测 ( 仅 设 备 ) 

> USB_INTCTRL_DISCONNECT// 设 备 断 开 检 测 ( 仅 主机 ) 

> USB_INTCTRL_CONNECT// 设 备 连接 检测 〈 仅 主机 ) 

> USB_INTCTRL_SOF// 起 始 帧 检测 

> USB_INTCTRL_BABBLE//USB 控制 器 检测 到 设备 发 出 的 过 去 一 帧 的 结束 信号 ( 付 ヨ 
机 ) 
> USB_INTCTRL_RESET// 由 设备 发 出 的 复位 信号 检测 ( 仅 设 备 ) 
> USB_INTCTRL_RESUME// 恢 复 信 号 检测 
> USB_INTCTRL_SUSPEND// 由 设备 发 出 的 挂 起 信号 检测 ( 仅 设备 ) 
> USB_INTCTRL_MODE_DETECT//OTG 电缆 模式 检测 已 经 完成 (OTC) 
> USB_INTCTRL_POWER_FAULT// 电 源 故 障 检测 〈 仅 主机 ) 
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表 工 -62 USBIntStatusEndpoint 






























































































































































































































































功能 返回 给 定 USB 控制 器 的 端点 中 断 状态 
函数 原型 uint32_t USBIntStatusEndpoint ( mnt32_t ui32 Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
该 函数 读 取 USB 控制 器 端点 的 中 断 状态 。 这 个 调用 仅 返 回 端 点 中 断 的 当前 状态 ， 控 制 中 
描述 断 状 态 可 通过 调用 USBIntStatusConrol( ) 来 获取 。 返 回 的 位 值 应 该 比 对 USB_INTEP_* 的 
Be 值 。 这 些 值 被 分 成 USB_INTEP_HOST_* 和 USB_INTEP_DEV_* 两 组 ， 以 处 理 所 有 端点 的 
主机 和 设备 模式 
返回 返回 USB 控制 器 的 端点 中 断 状 态 
表 工 -63 USBIntUnregister 
功能 注销 USB 控制 器 的 中 断 处 理 程序 
函数 原型 void USBIntUnregister (uint32_t ui32 Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
描述 该 函数 注销 中 断 处 理 程序 。 这 个 函数 也 可 禁止 中 断 控 制 器 中 的 USB 中 断 
返回 元 
表 L-64 USBModeConfig 
功能 改变 USB 控制 器 的 操作 模式 
ーー Void USBModeConfig ( uint32_t ui32Base, 
函数 原型 uint32_t ui32Mode) 
参数 ui32Base 指定 USB 模块 的 基地 址 
= ui32Mode 指定 的 USB OTG 引 脚 的 操作 模式 
该 函数 改变 USB 控制 右 的 操作 模式 。 在 完全 OTG 模式 下 操作 时 ，USB 控制 器 使 用 的 VBUS 
和 TID 引 脚 来 检测 模式 和 电压 的 变化 。 而 这 些 引 脚 主要 用 于 OTG 模式 ， 它 们 也 可 以 影响 主机 
和 设备 模式 的 操作 。 在 设备 模式 下 USB 控制 器 可 配置 成 监控 或 忽略 VBUS。 监 控 VBUS 允许 
控制 器 确定 它 是 否 已 从 主机 断 开 。 在 主机 模式 下 ，USB 控制 器 使 用 VBUS 引 脚 ， 检 测 由 于 过 
度 功 耗 引起 的 VBUS 电压 下 降 所 带 来 的 VBUS 损失 。 这 个 调用 取 USBHostMode( ) 、USBDe- 
viceMode( ) 、USBOTGMode( ) 函数 
描述 ui32Mode 的 值 应 为 下 列 值 之 一 : 
PR > USB_MODE_OTC// 使 能 完全 OTG 模式 操作 , VBUS 和 ID 由 控制 器 使 用 
> USB_MODE_HOST// 使 能 仅 作为 主机 的 操作 ， 无 VBUS 监控 或 ID 引 脚 
> USB_MODE_HOST_VBUS// 使 能 仅 作 为 主机 的 操作 ， 有 VBUS 监控 或 ID 引 脚 。 这 将 使 
能 VBUS 下 降 检测 ， 并 强迫 工作 在 主机 模式 下 
> USB_MODE_DEVICE// 使 能 仅 作为 装置 的 操作 ， 无 VBUS 监控 或 ID 引 脚 
> USB_MODE_DEVICE_VBUS/ /使 能 仅 作为 装置 的 操作 带 VBUS 引 脚 监控 。 这 将 使 能 断 
开 检 测 ， 并 强迫 工作 在 设备 模式 下 
返回 元 
表 L-65 USBModeGet 
功能 返回 控制 器 的 当前 操作 模式 
函数 原型 uint32_t USBModeGCet (uint32_t ui32Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
该 函数 返回 USB 控制 器 的 当前 操作 模式 - OTG 或 双 模式 功能 
描述 对 于 OTG 控制 器 ， 该 函数 将 返回 OTG 控制 器 的 下 值 之 一 : 














> USB_OTG_MODE_ASIDE_HOST 


> USB_OTG_MODE_ASIDE_DEV 
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> USB_OTG_MODE_BSIDE_HOST 
> USB_OTC_MODE_BSIDE_DEV 

> USB_OTG_MODE_NONE 

> USB_OTG_MODE_ASIDE_HOST /指示 在 主机 模式 中 控制 器 A 侧 电缆 








































































































































































































描述 > USB_OTC_MODE_> ASIDE DEV /指示 在 设备 模式 中 控制 器 A 侧 电缆 
> USB_OTG_MODE_BSIDE_HOST /指示 在 主机 模式 中 控制 器 B 侧 电缆 
> USB_OTG_MODE_BSIDE_DEV /指示 在 设备 模式 中 控制 器 B 侧 电缆 。 如 果 一 个 OTG 
会 话 请 求 开 始 〈 在 恰当 的 位 置 无 电缆 ) ， 这 种 模式 为 默认 
> USB_OTG_MODE_NONE // 表 明 控 制 器 不 试图 确定 其 在 系统 中 的 作 
对 于 双 模 式 控 制 器 ， 该 函数 将 返回 下 列 值 之 一 : 
> USB_DUAL_MODE_HOST 
描述 > USB_DUAL MODE_DEVICE 
NS > USB_DUAL_MODE_NONE 
> USB_DUAL_MODE_HOST /指示 控制 器 作为 主机 
> USB_DUAL_MODE_DEVICE /指示 控制 器 作为 设备 
> USB_DUAL_MODE_NONE /表明 控制 器 无 论 作为 主机 还 是 设备 都 未 激活 
函数 返 回 
> USB_OTC_MODE_ASIDE_HOST 
> USB_OTC_MODE_ASIDE_DEV 
> USB_OTC_MODE_BSIDE_HOST 
返 回 > USB_OTCG_MODE_BSIDE_DEV 
> USB_OTC_MODE_NONE 
> USB_DUAL_MODE_HOST 
> USB_DUAL_MODE_DEVICE 
> USB_DUAL_ MODE_NONE 
表 工 -66 USBNumEndpointsGet 
功能 返回 设备 上 USB 端点 对 的 个 数 
函数 原型 uint32_t USBNumEndpointsGet (uint32_t ui32Base) 
参数 ui32Base 指定 USB 模块 的 基地 址 
该 函数 返回 传递 基地 址 对 应 的 USB 点 对 个 数 。 返 回 值 为 可 的 IN 或 
描述 OUT 端点 的 个 数 ， 但 不 包括 端点 0 (控制 端点 ) 。 例 如 ， 如 果 返 回 即 除了 端点 0 外 ， 
包括 15 个 IN 端点 和 15 个 OUT 端点 
返回 返回 可 用 的 IN 或 0UT 端点 的 个 数 
表 L-67 USBOTGMode 
功能 将 USB 控制 器 改变 为 OTG 模式 
函数 原型 void USBOTGMode (uint32_t mi32Base ) 
参数 ui32Base 指定 USB 模块 的 基地 址 
描述 交 函 数 用 于 将 USB 控制 器 改变 为 OTG 模式 。 此 函数 具 逝 用 手 具有 OTG 功能 的 微 控 制 器 
返回 元 
表 工 -68 USBOTGSessionRequest 
功能 始 或 结束 一 次 会 话 
る 本邦 void USBOTGSessionRequest ( uint32_t ui32 Base , 
函数 原 bool bStart ) 
参数 ui32Base 指定 USB 模块 的 基地 址 








bStart ”指定 是 调用 开始 会 话 ， 还 是 调用 结束 会 话 
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( 续 ) 











该 函数 用 于 在 OTG 模式 下 开始 一 次 会 话 请 求 或 结束 一 次 会 话 。 如 果 参 数 pStart 设置 为 














































































































描述 bue， 则 该 函数 将 开始 一 次 会 话 ， 如 果 pStart 为 false 将 结束 一 次 会 话 
返回 无 
表 L-69 USBPHYPowerOff 
功能 关闭 USB PHY 电源 
函数 原型 void USBPHYPowerOff (uint32_t ui32Base) 
参数 ui32Base 指定 USB 模块 的 基地 址 
描述 | 该 函数 可 关闭 USB PHY 电源 ， 以 减少 该 设备 的 电流 消耗 。 在 关机 状态 USB 控制 器 将 无 
法 操作 
返回 无 
表 L-70 USBPHYPowerOn 
功能 打开 USB PHY 电源 
函数 原型 void USBPHYPowerOn (uint32_t ui32Base ) 
参 数 ui32Base 指定 USB 模块 的 基地 址 
描述 该 函数 打开 USB PHY 电源 ， 使 能 ビ 閣 返上 正常 操 作 状态 。 默认 情况 下 ，PHY 是 打开 的 ， 
所 以 只 在 已 调用 USBPHYPowerOff( ) 函数 时 ， 才 需 调 用 该 函数 
返回 无 
注 : 


1. Using USB with the uDMA Controller (固件 库 翻 译 省 略 ， 有 需要 用 到 这 部 分 的 读者 请 
見 TI USB Controller 固件 库 部 分 ) 。 

2. USB Link Power Management Functions (固件 库 翻译 省 略 ) 。 

3. USB UTMI Low Pin Interface (ULPI) ( 国 件 库 翻 译 省 略 ) 。 
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